@tochii/errors 0.1.2 → 0.1.8

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+## 0.1.8 (October 2026)
+
+<!-- release:start -->
+
+### Bug fixes
+#### Ci
+- Resynced with `dbx sync` to avoid drift ([#1c6f358](https://github.com/tochiResources/errors/commit/1c6f358) by [T0chi](https://github.com/T0chi))
+
+<!-- release:end -->
+
+
+## 0.1.7 (October 2026)
+
+### Bug fixes
+#### Ci
+- Change trigger for `nuget.yml` workflow to `release` ([#582ad2c](https://github.com/tochiResources/errors/commit/582ad2c) by [T0chi](https://github.com/T0chi))
+
+## 0.1.6 (October 2026)
+
+### CI
+- Updated workflows ([#b1a1b89](https://github.com/tochiResources/errors/commit/b1a1b89) by [T0chi](https://github.com/T0chi))
+
+## 0.1.5 (October 2026)
+
+### CI
+- Added `dev` to `ci.yml`'s push branches ([#ff15308](https://github.com/tochiResources/errors/commit/ff15308) by [T0chi](https://github.com/T0chi))
+
+## 0.1.4 (October 2026)
+
+### CI
+- Updated workflows ([#b2e3380](https://github.com/tochiResources/errors/commit/b2e3380) by [T0chi](https://github.com/T0chi))
+
+## 0.1.3 (October 2026)
+
+### Chores
+- Set package to public ([#a8428d3](https://github.com/tochiResources/errors/commit/a8428d3) by [T0chi](https://github.com/T0chi))
+
+## 0.1.2 (October 2026)
+
+### CI
+- Updated added `dev` branch ([#4b928a6](https://github.com/tochiResources/errors/commit/4b928a6) by [T0chi](https://github.com/T0chi))
+- Updated changelog branch ([#59a6f69](https://github.com/tochiResources/errors/commit/59a6f69) by [T0chi](https://github.com/T0chi))
+- Updated packaging flow ([#b4f3dbb](https://github.com/tochiResources/errors/commit/b4f3dbb) by [T0chi](https://github.com/T0chi))
+### Chores
+- Added `CHANGELOG.md` ([#1b53d03](https://github.com/tochiResources/errors/commit/1b53d03) by [T0chi](https://github.com/T0chi))
+- Code cleanup ([#e914f15](https://github.com/tochiResources/errors/commit/e914f15) by [T0chi](https://github.com/T0chi))
+- Update package.json description ([#edf61d0](https://github.com/tochiResources/errors/commit/edf61d0) by [T0chi](https://github.com/T0chi))
+#### Errors
+- Initialize repository ([#e39bad5](https://github.com/tochiResources/errors/commit/e39bad5) by [T0chi](https://github.com/T0chi))
+
+## 0.1.1 (October 2026)
+
+### CI
+- Updated packaging flow ([#b4f3dbb](https://github.com/tochiResources/errors/commit/b4f3dbb) by T0chi)
+### Chores
+- Code cleanup ([#e914f15](https://github.com/tochiResources/errors/commit/e914f15) by T0chi)
+- Update package.json description ([#edf61d0](https://github.com/tochiResources/errors/commit/edf61d0) by T0chi)
+#### Errors
+- Initialize repository ([#e39bad5](https://github.com/tochiResources/errors/commit/e39bad5) by T0chi)

package/README.md

@@ -1,5 +1,8 @@
 # @tochii/errors
 
+[![tests](https://img.shields.io/github/actions/workflow/status/tochiResources/errors/ci.yml?label=tests&logo=github)](https://github.com/tochiResources/errors/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@tochii/errors.svg?color=cb3837&label=npm)](https://www.npmjs.com/package/@tochii/errors)
+
 Shared typed errors and stable error codes used in official tochiResources proejcts.
 
 - **Stable codes**: the string value is part of the contract; never reuse or rename one. Both TS and C# switch on it.

package/csharp/Errors.cs

@@ -1,275 +1,275 @@
-using System;
-using System.Collections.Generic;
-
-namespace TochiRes.Errors;
-
-/// <summary>
-/// Stable error codes shared with the TypeScript side (<c>@tochii/errors</c>).
-/// Keep in sync with <c>src/codes.ts</c>. A code is part of the
-/// public contract: never rename or reuse one — add a new code instead.
-/// </summary>
-public static class ErrorCodes
-{
-    // General
-    public const string Unknown = "TOCHIRES_UNKNOWN";
-    public const string Internal = "TOCHIRES_INTERNAL";
-
-    // Config
-    public const string ConfigInvalid = "TOCHIRES_CONFIG_INVALID";
-    public const string ConfigMissing = "TOCHIRES_CONFIG_MISSING";
-
-    // Validation
-    public const string ValidationFailed = "TOCHIRES_VALIDATION_FAILED";
-
-    // API / HTTP boundary
-    public const string ApiBadRequest = "TOCHIRES_API_BAD_REQUEST";
-    public const string ApiUnauthorized = "TOCHIRES_API_UNAUTHORIZED";
-    public const string ApiForbidden = "TOCHIRES_API_FORBIDDEN";
-    public const string ApiNotFound = "TOCHIRES_API_NOT_FOUND";
-    public const string ApiConflict = "TOCHIRES_API_CONFLICT";
-    public const string ApiUnprocessable = "TOCHIRES_API_UNPROCESSABLE";
-    public const string ApiTooManyRequests = "TOCHIRES_API_TOO_MANY_REQUESTS";
-    public const string ApiTimeout = "TOCHIRES_API_TIMEOUT";
-    public const string ApiUnavailable = "TOCHIRES_API_UNAVAILABLE";
-
-    // IPC
-    public const string IpcTransport = "TOCHIRES_IPC_TRANSPORT";
-    public const string IpcProtocol = "TOCHIRES_IPC_PROTOCOL";
-    public const string IpcTimeout = "TOCHIRES_IPC_TIMEOUT";
-    public const string IpcAuth = "TOCHIRES_IPC_AUTH";
-    public const string IpcDisconnected = "TOCHIRES_IPC_DISCONNECTED";
-    public const string IpcBackpressure = "TOCHIRES_IPC_BACKPRESSURE";
-
-    // Codegen
-    public const string CodegenUnsupported = "TOCHIRES_CODEGEN_UNSUPPORTED";
-    public const string CodegenEmit = "TOCHIRES_CODEGEN_EMIT";
-    public const string CodegenRoundtrip = "TOCHIRES_CODEGEN_ROUNDTRIP";
-
-    // CSS
-    public const string CssParse = "TOCHIRES_CSS_PARSE";
-    public const string CssUnsupportedProperty = "TOCHIRES_CSS_UNSUPPORTED_PROPERTY";
-    public const string CssUnsupportedSelector = "TOCHIRES_CSS_UNSUPPORTED_SELECTOR";
-
-    // Native
-    public const string NativeModuleNotFound = "TOCHIRES_NATIVE_MODULE_NOT_FOUND";
-    public const string NativeMethodNotFound = "TOCHIRES_NATIVE_METHOD_NOT_FOUND";
-    public const string NativeCallFailed = "TOCHIRES_NATIVE_CALL_FAILED";
-
-    // Build
-    public const string BuildFailed = "TOCHIRES_BUILD_FAILED";
-    public const string BuildToolMissing = "TOCHIRES_BUILD_TOOL_MISSING";
-
-    // Package
-    public const string PackageFailed = "TOCHIRES_PACKAGE_FAILED";
-    public const string PackageSigning = "TOCHIRES_PACKAGE_SIGNING";
-
-    // Settings
-    public const string SettingsParse = "TOCHIRES_SETTINGS_PARSE";
-    public const string SettingsInvalid = "TOCHIRES_SETTINGS_INVALID";
-
-    // Path
-    public const string PathInvalid = "TOCHIRES_PATH_INVALID";
-    public const string PathAbsolute = "TOCHIRES_PATH_ABSOLUTE";
-
-    /// <summary>Every known code, for validation and diagnostics.</summary>
-    public static readonly IReadOnlyList<string> All = new[]
-    {
-        Unknown, Internal,
-        ConfigInvalid, ConfigMissing,
-        ValidationFailed,
-        ApiBadRequest, ApiUnauthorized, ApiForbidden, ApiNotFound, ApiConflict,
-        ApiUnprocessable, ApiTooManyRequests, ApiTimeout, ApiUnavailable,
-        IpcTransport, IpcProtocol, IpcTimeout, IpcAuth, IpcDisconnected, IpcBackpressure,
-        CodegenUnsupported, CodegenEmit, CodegenRoundtrip,
-        CssParse, CssUnsupportedProperty, CssUnsupportedSelector,
-        NativeModuleNotFound, NativeMethodNotFound, NativeCallFailed,
-        BuildFailed, BuildToolMissing,
-        PackageFailed, PackageSigning,
-        SettingsParse, SettingsInvalid,
-        PathInvalid, PathAbsolute,
-    };
-
-    private static readonly IReadOnlyDictionary<string, string> CategoryByCode =
-        new Dictionary<string, string>(StringComparer.Ordinal)
-        {
-            [Unknown] = "general",
-            [Internal] = "general",
-            [ConfigInvalid] = "config",
-            [ConfigMissing] = "config",
-            [ValidationFailed] = "validation",
-            [ApiBadRequest] = "api",
-            [ApiUnauthorized] = "api",
-            [ApiForbidden] = "api",
-            [ApiNotFound] = "api",
-            [ApiConflict] = "api",
-            [ApiUnprocessable] = "api",
-            [ApiTooManyRequests] = "api",
-            [ApiTimeout] = "api",
-            [ApiUnavailable] = "api",
-            [IpcTransport] = "ipc",
-            [IpcProtocol] = "ipc",
-            [IpcTimeout] = "ipc",
-            [IpcAuth] = "ipc",
-            [IpcDisconnected] = "ipc",
-            [IpcBackpressure] = "ipc",
-            [CodegenUnsupported] = "codegen",
-            [CodegenEmit] = "codegen",
-            [CodegenRoundtrip] = "codegen",
-            [CssParse] = "css",
-            [CssUnsupportedProperty] = "css",
-            [CssUnsupportedSelector] = "css",
-            [NativeModuleNotFound] = "native",
-            [NativeMethodNotFound] = "native",
-            [NativeCallFailed] = "native",
-            [BuildFailed] = "build",
-            [BuildToolMissing] = "build",
-            [PackageFailed] = "package",
-            [PackageSigning] = "package",
-            [SettingsParse] = "settings",
-            [SettingsInvalid] = "settings",
-            [PathInvalid] = "path",
-            [PathAbsolute] = "path",
-        };
-
-    /// <summary>Whether <paramref name="code"/> is one of the known stable codes.</summary>
-    public static bool IsKnown(string? code) => code is not null && CategoryByCode.ContainsKey(code);
-
-    /// <summary>The category a code belongs to, or <c>"general"</c> when unknown.</summary>
-    public static string CategoryOf(string? code) =>
-        code is not null && CategoryByCode.TryGetValue(code, out var category) ? category : "general";
-}
-
-/// <summary>
-/// Base exception for every error defined by this package.
-/// Mirrors <c>TochiResError</c> from the TypeScript implementation.
-/// </summary>
-public class TochiResException : Exception
-{
-    /// <summary>Stable error code — part of the public contract.</summary>
-    public string Code { get; }
-
-    /// <summary>Coarse category derived from <see cref="Code"/>.</summary>
-    public string Category { get; }
-
-    /// <summary>Structured, JSON-safe context for logging and telemetry.</summary>
-    public IReadOnlyDictionary<string, object?>? Context { get; }
-
-    public TochiResException(
-        string code,
-        string message,
-        Exception? innerException = null,
-        IReadOnlyDictionary<string, object?>? context = null)
-        : base(message, innerException)
-    {
-        Code = code;
-        Category = ErrorCodes.CategoryOf(code);
-        Context = context;
-    }
-}
-
-/// <summary>Configuration is missing or failed validation.</summary>
-public sealed class ConfigException : TochiResException
-{
-    public ConfigException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.ConfigInvalid, message, inner, context) { }
-
-    public ConfigException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>A payload, schema or argument failed validation.</summary>
-public sealed class ValidationException : TochiResException
-{
-    public ValidationException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.ValidationFailed, message, inner, context) { }
-}
-
-/// <summary>An API/HTTP boundary failure (bad request, auth, not found, conflict, …).</summary>
-public sealed class ApiException : TochiResException
-{
-    public ApiException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.ApiBadRequest, message, inner, context) { }
-
-    public ApiException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>An IPC transport, protocol, authentication or timeout failure.</summary>
-public sealed class IpcException : TochiResException
-{
-    public IpcException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.IpcTransport, message, inner, context) { }
-
-    public IpcException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>A TS→C# code generator failed or hit an unsupported construct.</summary>
-public sealed class CodegenException : TochiResException
-{
-    public CodegenException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.CodegenEmit, message, inner, context) { }
-
-    public CodegenException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>CSS input is invalid or outside the supported subset.</summary>
-public sealed class CssException : TochiResException
-{
-    public CssException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.CssParse, message, inner, context) { }
-
-    public CssException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>A native module or method was missing, or a native call failed.</summary>
-public sealed class NativeException : TochiResException
-{
-    public NativeException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.NativeCallFailed, message, inner, context) { }
-
-    public NativeException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>A build pipeline step failed or a required tool is missing.</summary>
-public sealed class BuildException : TochiResException
-{
-    public BuildException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.BuildFailed, message, inner, context) { }
-
-    public BuildException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>A packaging, signing or notarization step failed.</summary>
-public sealed class PackageException : TochiResException
-{
-    public PackageException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.PackageFailed, message, inner, context) { }
-
-    public PackageException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>Settings text could not be parsed or failed validation.</summary>
-public sealed class SettingsException : TochiResException
-{
-    public SettingsException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.SettingsInvalid, message, inner, context) { }
-
-    public SettingsException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
-
-/// <summary>A path was malformed or violated the relative-path rule.</summary>
-public sealed class PathException : TochiResException
-{
-    public PathException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(ErrorCodes.PathInvalid, message, inner, context) { }
-
-    public PathException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
-        : base(code, message, inner, context) { }
-}
+using System;
+using System.Collections.Generic;
+
+namespace TochiRes.Errors;
+
+/// <summary>
+/// Stable error codes shared with the TypeScript side (<c>@tochii/errors</c>).
+/// Keep in sync with <c>src/codes.ts</c>. A code is part of the
+/// public contract: never rename or reuse one — add a new code instead.
+/// </summary>
+public static class ErrorCodes
+{
+    // General
+    public const string Unknown = "TOCHIRES_UNKNOWN";
+    public const string Internal = "TOCHIRES_INTERNAL";
+
+    // Config
+    public const string ConfigInvalid = "TOCHIRES_CONFIG_INVALID";
+    public const string ConfigMissing = "TOCHIRES_CONFIG_MISSING";
+
+    // Validation
+    public const string ValidationFailed = "TOCHIRES_VALIDATION_FAILED";
+
+    // API / HTTP boundary
+    public const string ApiBadRequest = "TOCHIRES_API_BAD_REQUEST";
+    public const string ApiUnauthorized = "TOCHIRES_API_UNAUTHORIZED";
+    public const string ApiForbidden = "TOCHIRES_API_FORBIDDEN";
+    public const string ApiNotFound = "TOCHIRES_API_NOT_FOUND";
+    public const string ApiConflict = "TOCHIRES_API_CONFLICT";
+    public const string ApiUnprocessable = "TOCHIRES_API_UNPROCESSABLE";
+    public const string ApiTooManyRequests = "TOCHIRES_API_TOO_MANY_REQUESTS";
+    public const string ApiTimeout = "TOCHIRES_API_TIMEOUT";
+    public const string ApiUnavailable = "TOCHIRES_API_UNAVAILABLE";
+
+    // IPC
+    public const string IpcTransport = "TOCHIRES_IPC_TRANSPORT";
+    public const string IpcProtocol = "TOCHIRES_IPC_PROTOCOL";
+    public const string IpcTimeout = "TOCHIRES_IPC_TIMEOUT";
+    public const string IpcAuth = "TOCHIRES_IPC_AUTH";
+    public const string IpcDisconnected = "TOCHIRES_IPC_DISCONNECTED";
+    public const string IpcBackpressure = "TOCHIRES_IPC_BACKPRESSURE";
+
+    // Codegen
+    public const string CodegenUnsupported = "TOCHIRES_CODEGEN_UNSUPPORTED";
+    public const string CodegenEmit = "TOCHIRES_CODEGEN_EMIT";
+    public const string CodegenRoundtrip = "TOCHIRES_CODEGEN_ROUNDTRIP";
+
+    // CSS
+    public const string CssParse = "TOCHIRES_CSS_PARSE";
+    public const string CssUnsupportedProperty = "TOCHIRES_CSS_UNSUPPORTED_PROPERTY";
+    public const string CssUnsupportedSelector = "TOCHIRES_CSS_UNSUPPORTED_SELECTOR";
+
+    // Native
+    public const string NativeModuleNotFound = "TOCHIRES_NATIVE_MODULE_NOT_FOUND";
+    public const string NativeMethodNotFound = "TOCHIRES_NATIVE_METHOD_NOT_FOUND";
+    public const string NativeCallFailed = "TOCHIRES_NATIVE_CALL_FAILED";
+
+    // Build
+    public const string BuildFailed = "TOCHIRES_BUILD_FAILED";
+    public const string BuildToolMissing = "TOCHIRES_BUILD_TOOL_MISSING";
+
+    // Package
+    public const string PackageFailed = "TOCHIRES_PACKAGE_FAILED";
+    public const string PackageSigning = "TOCHIRES_PACKAGE_SIGNING";
+
+    // Settings
+    public const string SettingsParse = "TOCHIRES_SETTINGS_PARSE";
+    public const string SettingsInvalid = "TOCHIRES_SETTINGS_INVALID";
+
+    // Path
+    public const string PathInvalid = "TOCHIRES_PATH_INVALID";
+    public const string PathAbsolute = "TOCHIRES_PATH_ABSOLUTE";
+
+    /// <summary>Every known code, for validation and diagnostics.</summary>
+    public static readonly IReadOnlyList<string> All = new[]
+    {
+        Unknown, Internal,
+        ConfigInvalid, ConfigMissing,
+        ValidationFailed,
+        ApiBadRequest, ApiUnauthorized, ApiForbidden, ApiNotFound, ApiConflict,
+        ApiUnprocessable, ApiTooManyRequests, ApiTimeout, ApiUnavailable,
+        IpcTransport, IpcProtocol, IpcTimeout, IpcAuth, IpcDisconnected, IpcBackpressure,
+        CodegenUnsupported, CodegenEmit, CodegenRoundtrip,
+        CssParse, CssUnsupportedProperty, CssUnsupportedSelector,
+        NativeModuleNotFound, NativeMethodNotFound, NativeCallFailed,
+        BuildFailed, BuildToolMissing,
+        PackageFailed, PackageSigning,
+        SettingsParse, SettingsInvalid,
+        PathInvalid, PathAbsolute,
+    };
+
+    private static readonly IReadOnlyDictionary<string, string> CategoryByCode =
+        new Dictionary<string, string>(StringComparer.Ordinal)
+        {
+            [Unknown] = "general",
+            [Internal] = "general",
+            [ConfigInvalid] = "config",
+            [ConfigMissing] = "config",
+            [ValidationFailed] = "validation",
+            [ApiBadRequest] = "api",
+            [ApiUnauthorized] = "api",
+            [ApiForbidden] = "api",
+            [ApiNotFound] = "api",
+            [ApiConflict] = "api",
+            [ApiUnprocessable] = "api",
+            [ApiTooManyRequests] = "api",
+            [ApiTimeout] = "api",
+            [ApiUnavailable] = "api",
+            [IpcTransport] = "ipc",
+            [IpcProtocol] = "ipc",
+            [IpcTimeout] = "ipc",
+            [IpcAuth] = "ipc",
+            [IpcDisconnected] = "ipc",
+            [IpcBackpressure] = "ipc",
+            [CodegenUnsupported] = "codegen",
+            [CodegenEmit] = "codegen",
+            [CodegenRoundtrip] = "codegen",
+            [CssParse] = "css",
+            [CssUnsupportedProperty] = "css",
+            [CssUnsupportedSelector] = "css",
+            [NativeModuleNotFound] = "native",
+            [NativeMethodNotFound] = "native",
+            [NativeCallFailed] = "native",
+            [BuildFailed] = "build",
+            [BuildToolMissing] = "build",
+            [PackageFailed] = "package",
+            [PackageSigning] = "package",
+            [SettingsParse] = "settings",
+            [SettingsInvalid] = "settings",
+            [PathInvalid] = "path",
+            [PathAbsolute] = "path",
+        };
+
+    /// <summary>Whether <paramref name="code"/> is one of the known stable codes.</summary>
+    public static bool IsKnown(string? code) => code is not null && CategoryByCode.ContainsKey(code);
+
+    /// <summary>The category a code belongs to, or <c>"general"</c> when unknown.</summary>
+    public static string CategoryOf(string? code) =>
+        code is not null && CategoryByCode.TryGetValue(code, out var category) ? category : "general";
+}
+
+/// <summary>
+/// Base exception for every error defined by this package.
+/// Mirrors <c>TochiResError</c> from the TypeScript implementation.
+/// </summary>
+public class TochiResException : Exception
+{
+    /// <summary>Stable error code — part of the public contract.</summary>
+    public string Code { get; }
+
+    /// <summary>Coarse category derived from <see cref="Code"/>.</summary>
+    public string Category { get; }
+
+    /// <summary>Structured, JSON-safe context for logging and telemetry.</summary>
+    public IReadOnlyDictionary<string, object?>? Context { get; }
+
+    public TochiResException(
+        string code,
+        string message,
+        Exception? innerException = null,
+        IReadOnlyDictionary<string, object?>? context = null)
+        : base(message, innerException)
+    {
+        Code = code;
+        Category = ErrorCodes.CategoryOf(code);
+        Context = context;
+    }
+}
+
+/// <summary>Configuration is missing or failed validation.</summary>
+public sealed class ConfigException : TochiResException
+{
+    public ConfigException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.ConfigInvalid, message, inner, context) { }
+
+    public ConfigException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>A payload, schema or argument failed validation.</summary>
+public sealed class ValidationException : TochiResException
+{
+    public ValidationException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.ValidationFailed, message, inner, context) { }
+}
+
+/// <summary>An API/HTTP boundary failure (bad request, auth, not found, conflict, …).</summary>
+public sealed class ApiException : TochiResException
+{
+    public ApiException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.ApiBadRequest, message, inner, context) { }
+
+    public ApiException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>An IPC transport, protocol, authentication or timeout failure.</summary>
+public sealed class IpcException : TochiResException
+{
+    public IpcException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.IpcTransport, message, inner, context) { }
+
+    public IpcException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>A TS→C# code generator failed or hit an unsupported construct.</summary>
+public sealed class CodegenException : TochiResException
+{
+    public CodegenException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.CodegenEmit, message, inner, context) { }
+
+    public CodegenException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>CSS input is invalid or outside the supported subset.</summary>
+public sealed class CssException : TochiResException
+{
+    public CssException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.CssParse, message, inner, context) { }
+
+    public CssException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>A native module or method was missing, or a native call failed.</summary>
+public sealed class NativeException : TochiResException
+{
+    public NativeException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.NativeCallFailed, message, inner, context) { }
+
+    public NativeException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>A build pipeline step failed or a required tool is missing.</summary>
+public sealed class BuildException : TochiResException
+{
+    public BuildException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.BuildFailed, message, inner, context) { }
+
+    public BuildException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>A packaging, signing or notarization step failed.</summary>
+public sealed class PackageException : TochiResException
+{
+    public PackageException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.PackageFailed, message, inner, context) { }
+
+    public PackageException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>Settings text could not be parsed or failed validation.</summary>
+public sealed class SettingsException : TochiResException
+{
+    public SettingsException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.SettingsInvalid, message, inner, context) { }
+
+    public SettingsException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}
+
+/// <summary>A path was malformed or violated the relative-path rule.</summary>
+public sealed class PathException : TochiResException
+{
+    public PathException(string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(ErrorCodes.PathInvalid, message, inner, context) { }
+
+    public PathException(string code, string message, Exception? inner = null, IReadOnlyDictionary<string, object?>? context = null)
+        : base(code, message, inner, context) { }
+}

package/package.json

@@ -1,57 +1,56 @@
 {
-    "name": "@tochii/errors",
-    "version": "0.1.2",
-    "description": "Shared typed errors and stable error codes used in official tochiResources proejcts.",
-    "license": "MIT",
-    "author": "T0chi",
-    "type": "module",
-    "private": false,
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/tochiResources/errors.git"
-    },
-    "scripts": {
-        "build": "tsdown --config-loader unrun",
-        "format": "dbx fmt",
-        "lint": "dbx lint --fix",
-        "check": "dbx check",
-        "test": "vitest run",
-        "typecheck": "tsc -p tsconfig.build.json --noEmit",
-        "dbx": "dbx",
-        "commitlint": "commitlint",
-        "prepare": "husky"
-    },
-    "devDependencies": {
-        "@commitlint/cli": "^21.2.2",
-        "@commitlint/config-conventional": "^21.2.2",
-        "@deltabox/toolchain": "^1.11.3",
-        "@types/node": "catalog:",
-        "@typescript/native-preview": "catalog:",
-        "husky": "^9.1.7",
-        "tsdown": "catalog:",
-        "tsx": "catalog:",
-        "typescript": "catalog:",
-        "unrun": "^0.3.1",
-        "vite": "catalog:",
-        "vite-plus": "^1.2.0",
-        "vitest": "catalog:"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "packageManager": "yarn@4.17.1",
-    "engines": {
-        "node": ">=22.5.0"
-    },
-    "files": [
-        "dist",
-        "csharp"
-    ],
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": "./dist/index.js",
-        "./codes": "./dist/codes.js",
-        "./serialize": "./dist/serialize.js",
-        "./package.json": "./package.json"
-    }
-}
+  "name": "@tochii/errors",
+  "version": "0.1.8",
+  "description": "Shared typed errors and stable error codes used in official tochiResources proejcts.",
+  "license": "MIT",
+  "author": "T0chi",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tochiResources/errors.git"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader unrun",
+    "format": "dbx fmt",
+    "lint": "dbx lint --fix",
+    "check": "dbx check",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "dbx": "dbx",
+    "commitlint": "commitlint",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.2.2",
+    "@commitlint/config-conventional": "^21.2.2",
+    "@deltabox/toolchain": "^1.11.3",
+    "@types/node": "^22.10.2",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "husky": "^9.1.7",
+    "tsdown": "^0.23.0",
+    "tsx": "^4.23.13",
+    "typescript": "^6.0.3",
+    "unrun": "^0.3.1",
+    "vite": "^8.3.0",
+    "vite-plus": "^1.2.0",
+    "vitest": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "yarn@4.17.1",
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "files": [
+    "dist",
+    "csharp"
+  ],
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./codes": "./dist/codes.js",
+    "./serialize": "./dist/serialize.js",
+    "./package.json": "./package.json"
+  }
+}