icore 1.0.14 → 1.0.15

package/dist/cli.d.ts

@@ -9,6 +9,6 @@
  * This file must not contain parser, validator, or command runtime logic.
  */
 export { parseArgv, type ParsedArgv } from './argv';
-export { defineCommand, defineCommandRegistry, isCommandName, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type CommandDefinition, type CommandContext, type CommandInput, type CommandName, type CommandPayload, type CommandRegistry, type CommandResolutionOptions, type CommandResult, type PreparedCommand, type PreparedCommandInput, type ResolvedCommand } from './commands';
+export { defineCommand, defineCommandRegistry, isCommandName, isPreparedCommandName, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type CommandDefinition, type CommandContext, type CommandInput, type CommandName, type CommandPayload, type CommandRegistry, type CommandResolutionOptions, type CommandResult, type PreparedCommand, type PreparedCommandInput, type ResolvedCommand } from './commands';
 export { IcoreError, type IcoreErrorCode, type IcoreErrorDetails } from './errors';
 export { mergeOptionsSchema, parseOptions, parseOptionsDetailed, type BooleanOption, type InferOptions, type InferProvidedOptions, type MergeOptionsSchemas, type NumberOption, type OptionDefinition, type OptionsSchema, type ParseOptionsResult, type RawOptionValue, type StringOption } from './options';

package/dist/cli.js

@@ -10,13 +10,14 @@
  * This file must not contain parser, validator, or command runtime logic.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseOptionsDetailed = exports.parseOptions = exports.mergeOptionsSchema = exports.IcoreError = exports.runCommandFromRegistry = exports.runPreparedCommand = exports.runCommand = exports.resolveCommandFromArgs = exports.resolveCommand = exports.prepareCommandFromArgs = exports.isCommandName = exports.defineCommandRegistry = exports.defineCommand = exports.parseArgv = void 0;
+exports.parseOptionsDetailed = exports.parseOptions = exports.mergeOptionsSchema = exports.IcoreError = exports.runCommandFromRegistry = exports.runPreparedCommand = exports.runCommand = exports.resolveCommandFromArgs = exports.resolveCommand = exports.prepareCommandFromArgs = exports.isPreparedCommandName = exports.isCommandName = exports.defineCommandRegistry = exports.defineCommand = exports.parseArgv = void 0;
 var argv_1 = require("./argv");
 Object.defineProperty(exports, "parseArgv", { enumerable: true, get: function () { return argv_1.parseArgv; } });
 var commands_1 = require("./commands");
 Object.defineProperty(exports, "defineCommand", { enumerable: true, get: function () { return commands_1.defineCommand; } });
 Object.defineProperty(exports, "defineCommandRegistry", { enumerable: true, get: function () { return commands_1.defineCommandRegistry; } });
 Object.defineProperty(exports, "isCommandName", { enumerable: true, get: function () { return commands_1.isCommandName; } });
+Object.defineProperty(exports, "isPreparedCommandName", { enumerable: true, get: function () { return commands_1.isPreparedCommandName; } });
 Object.defineProperty(exports, "prepareCommandFromArgs", { enumerable: true, get: function () { return commands_1.prepareCommandFromArgs; } });
 Object.defineProperty(exports, "resolveCommand", { enumerable: true, get: function () { return commands_1.resolveCommand; } });
 Object.defineProperty(exports, "resolveCommandFromArgs", { enumerable: true, get: function () { return commands_1.resolveCommandFromArgs; } });

package/dist/commands.d.ts

@@ -137,6 +137,12 @@ export declare function defineCommandRegistry<const TCommands extends readonly A
  * Checks whether a value is a command name registered in the given registry.
  */
 export declare function isCommandName<const TCommands extends readonly AnyCommandDefinition[]>(registry: CommandRegistry<TCommands>, value: unknown): value is CommandName<TCommands[number]>;
+/**
+ * Checks whether a prepared command has the given command name.
+ */
+export declare function isPreparedCommandName<TPrepared extends PreparedCommand<AnyCommandDefinition>, TName extends TPrepared['name']>(prepared: TPrepared, name: TName): prepared is Extract<TPrepared, {
+    name: TName;
+}>;
 /**
  * Resolves a command from already parsed positional arguments.
  */

package/dist/commands.js

@@ -15,6 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineCommand = defineCommand;
 exports.defineCommandRegistry = defineCommandRegistry;
 exports.isCommandName = isCommandName;
+exports.isPreparedCommandName = isPreparedCommandName;
 exports.resolveCommand = resolveCommand;
 exports.resolveCommandFromArgs = resolveCommandFromArgs;
 exports.prepareCommandFromArgs = prepareCommandFromArgs;
@@ -48,6 +49,12 @@ function isCommandName(registry, value) {
     return typeof value === 'string'
         && registry.commandNames.includes(value);
 }
+/**
+ * Checks whether a prepared command has the given command name.
+ */
+function isPreparedCommandName(prepared, name) {
+    return prepared.name === name;
+}
 /**
  * Resolves a command from already parsed positional arguments.
  */

package/dist/index.d.ts

@@ -1 +1 @@
-export { defineCommand, defineCommandRegistry, IcoreError, isCommandName, mergeOptionsSchema, parseArgv, parseOptions, parseOptionsDetailed, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type BooleanOption, type CommandDefinition, type CommandContext, type CommandInput, type CommandName, type CommandPayload, type CommandRegistry, type CommandResolutionOptions, type CommandResult, type InferOptions, type InferProvidedOptions, type IcoreErrorCode, type IcoreErrorDetails, type MergeOptionsSchemas, type NumberOption, type OptionDefinition, type OptionsSchema, type ParseOptionsResult, type ParsedArgv, type PreparedCommand, type PreparedCommandInput, type RawOptionValue, type ResolvedCommand, type StringOption } from './cli';
+export { defineCommand, defineCommandRegistry, IcoreError, isCommandName, isPreparedCommandName, mergeOptionsSchema, parseArgv, parseOptions, parseOptionsDetailed, prepareCommandFromArgs, resolveCommand, resolveCommandFromArgs, runCommand, runPreparedCommand, runCommandFromRegistry, type BooleanOption, type CommandDefinition, type CommandContext, type CommandInput, type CommandName, type CommandPayload, type CommandRegistry, type CommandResolutionOptions, type CommandResult, type InferOptions, type InferProvidedOptions, type IcoreErrorCode, type IcoreErrorDetails, type MergeOptionsSchemas, type NumberOption, type OptionDefinition, type OptionsSchema, type ParseOptionsResult, type ParsedArgv, type PreparedCommand, type PreparedCommandInput, type RawOptionValue, type ResolvedCommand, type StringOption } from './cli';

package/dist/index.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCommandFromRegistry = exports.runPreparedCommand = exports.runCommand = exports.resolveCommandFromArgs = exports.resolveCommand = exports.prepareCommandFromArgs = exports.parseOptionsDetailed = exports.parseOptions = exports.parseArgv = exports.mergeOptionsSchema = exports.isCommandName = exports.IcoreError = exports.defineCommandRegistry = exports.defineCommand = void 0;
+exports.runCommandFromRegistry = exports.runPreparedCommand = exports.runCommand = exports.resolveCommandFromArgs = exports.resolveCommand = exports.prepareCommandFromArgs = exports.parseOptionsDetailed = exports.parseOptions = exports.parseArgv = exports.mergeOptionsSchema = exports.isPreparedCommandName = exports.isCommandName = exports.IcoreError = exports.defineCommandRegistry = exports.defineCommand = void 0;
 var cli_1 = require("./cli");
 Object.defineProperty(exports, "defineCommand", { enumerable: true, get: function () { return cli_1.defineCommand; } });
 Object.defineProperty(exports, "defineCommandRegistry", { enumerable: true, get: function () { return cli_1.defineCommandRegistry; } });
 Object.defineProperty(exports, "IcoreError", { enumerable: true, get: function () { return cli_1.IcoreError; } });
 Object.defineProperty(exports, "isCommandName", { enumerable: true, get: function () { return cli_1.isCommandName; } });
+Object.defineProperty(exports, "isPreparedCommandName", { enumerable: true, get: function () { return cli_1.isPreparedCommandName; } });
 Object.defineProperty(exports, "mergeOptionsSchema", { enumerable: true, get: function () { return cli_1.mergeOptionsSchema; } });
 Object.defineProperty(exports, "parseArgv", { enumerable: true, get: function () { return cli_1.parseArgv; } });
 Object.defineProperty(exports, "parseOptions", { enumerable: true, get: function () { return cli_1.parseOptions; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icore",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Declarative command line interface mechanics for Node.js",
   "keywords": [
     "command-line",
@@ -28,6 +28,7 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
+    "prepare": "tsc",
     "test": "node --test dist/*.test.js",
     "lint": "eslint src"
   },

package/readme.md

@@ -32,6 +32,7 @@ npm install icore
   - [`defineCommand(command)`](#definecommandcommand)
   - [`defineCommandRegistry(commands)`](#definecommandregistrycommands)
   - [`isCommandName(registry, value)`](#iscommandnameregistry-value)
+  - [`isPreparedCommandName(prepared, name)`](#ispreparedcommandnameprepared-name)
   - [`resolveCommand(registry, positionals)`](#resolvecommandregistry-positionals)
   - [`resolveCommandFromArgs(registry, args)`](#resolvecommandfromargsregistry-args)
   - [`prepareCommandFromArgs(registry, args, options?)`](#preparecommandfromargsregistry-args-options)
@@ -236,6 +237,17 @@ if (isCommandName(registry, value)) {
 }
 ```
 
+### `isPreparedCommandName(prepared, name)`
+
+Checks whether a prepared command has the given command name and narrows the
+prepared command union.
+
+```ts
+if (isPreparedCommandName(prepared, 'hello')) {
+  // prepared.payload is narrowed to the `hello` command payload.
+}
+```
+
 ### `resolveCommand(registry, positionals)`
 
 Resolves a command from already parsed positional arguments.

package/CHANGELOG.md

@@ -1,203 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-Historical entries before this file was introduced were reconstructed from npm
-publish metadata and local git history. Older entries are intentionally
-conservative.
-
-## [Unreleased]
-
-### Added
-
-- Added machine-readable `IcoreError` codes and details.
-- Added opt-in `strict: true` command resolution for rejecting options before command paths.
-- Added `strict: true` support to direct `runCommand` execution.
-- Added typed prepared command `payload` returned from `prepare` and passed to `handle`.
-- Added public `CommandPayload`, `CommandContext`, and `CommandResult` helper types.
-- Added this changelog.
-
-### Changed
-
-- Changed `PreparedCommand` typing to preserve payload correlation when narrowing registry unions by command name.
-
-### Removed
-
-- Removed explicit boolean values such as `--flag=true` and `--flag=false`; use `--flag` and `--no-flag`.
-
-## [1.0.12] - 2026-07-02
-
-### Changed
-
-- Replaced the preliminary flag-only boolean option naming with `syntax: 'flag'`.
-- Documented flag-only boolean option behavior.
-
-## [1.0.11] - 2026-07-02
-
-### Added
-
-- Added preliminary flag-only boolean option support.
-
-## [1.0.10] - 2026-07-02
-
-### Added
-
-- Added two-phase command execution.
-- Added `PreparedCommandInput`.
-- Added `PreparedCommand`.
-- Added `prepareCommandFromArgs`.
-- Added `runPreparedCommand`.
-- Added command `metadata`.
-- Added command `prepare` hook.
-- Added focused tests for prepare-time validation and handler safety.
-
-### Changed
-
-- Changed `runCommand` and `runCommandFromRegistry` to use the prepare-and-run flow internally.
-
-## [1.0.9] - 2026-07-02
-
-### Changed
-
-- Refined npm package metadata.
-- Updated repository metadata for npm.
-- Simplified published package contents.
-
-## [1.0.8] - 2026-07-02
-
-### Changed
-
-- Updated package author metadata.
-- Normalized README heading structure.
-
-## [1.0.7] - 2026-07-02
-
-### Changed
-
-- Renamed README examples from `upper` to `uppercase`.
-- Cleaned duplicated command test coverage without changing public behavior.
-
-## [1.0.6] - 2026-07-02
-
-### Added
-
-- Added explicit long boolean values such as `--flag=true` and `--flag=false`.
-- Added schema-known boolean negation such as `--no-flag`.
-- Added short option aliases such as `-f` and `-n value`.
-- Added alias validation and duplicate detection between short and long option forms.
-- Documented supported option syntax.
-
-## [1.0.5] - 2026-07-01
-
-### Changed
-
-- Rebuilt README as the main public documentation entry point.
-
-### Removed
-
-- Removed separate generated reference docs from the published documentation flow.
-
-## [1.0.4] - 2026-07-01
-
-### Changed
-
-- Reorganized README and documentation references.
-
-## [1.0.3] - 2026-07-01
-
-### Added
-
-- Added README table of contents.
-
-### Changed
-
-- Polished README formatting and emphasis.
-
-## [1.0.2] - 2026-06-30
-
-### Added
-
-- Added module boundary comments to production source files.
-
-### Changed
-
-- Clarified CLI scope and supported syntax in README.
-- Updated package description and keywords.
-
-## [1.0.1] - 2026-06-30
-
-### Changed
-
-- Published documentation updates after the first stable release.
-- No dedicated version commit is present in local git history for this patch.
-
-## [1.0.0] - 2026-06-30
-
-### Added
-
-- First stable release of the new `icore` CLI mechanics package.
-- Added declarative option parsing and validation.
-- Added schema-aware argv parsing.
-- Added option presence metadata through `parseOptionsDetailed`.
-- Added option schema composition through `mergeOptionsSchema`.
-- Added command registry routing.
-- Added typed command handler input.
-- Added CommonJS package entry points and TypeScript declarations.
-
-### Changed
-
-- Lowered the runtime Node.js engine to `>=16.9.0`.
-
-## [1.0.0-alpha] - 2026-06-28
-
-### Added
-
-- Started the new CLI mechanics codebase after pruning the legacy package code.
-- Added the initial TypeScript build, test, and lint setup for the new package.
-
-## [0.1.38] - 2019-06-12
-
-### Added
-
-- Added legacy tests and documentation.
-
-### Changed
-
-- Final legacy web-framework line release.
-- Updated the legacy package description.
-
-### Removed
-
-- Trimmed legacy runtime dependencies.
-
-## [0.0.37 and earlier]
-
-### Added
-
-- Original legacy npm package line published between 2017 and 2019.
-- Legacy history is preserved for package provenance.
-
-### Changed
-
-- Detailed changelog entries were not maintained for these releases.
-
-[Unreleased]: https://github.com/woodger/icore/commits/develop
-[1.0.12]: https://www.npmjs.com/package/icore/v/1.0.12
-[1.0.11]: https://www.npmjs.com/package/icore/v/1.0.11
-[1.0.10]: https://www.npmjs.com/package/icore/v/1.0.10
-[1.0.9]: https://www.npmjs.com/package/icore/v/1.0.9
-[1.0.8]: https://www.npmjs.com/package/icore/v/1.0.8
-[1.0.7]: https://www.npmjs.com/package/icore/v/1.0.7
-[1.0.6]: https://www.npmjs.com/package/icore/v/1.0.6
-[1.0.5]: https://www.npmjs.com/package/icore/v/1.0.5
-[1.0.4]: https://www.npmjs.com/package/icore/v/1.0.4
-[1.0.3]: https://www.npmjs.com/package/icore/v/1.0.3
-[1.0.2]: https://www.npmjs.com/package/icore/v/1.0.2
-[1.0.1]: https://www.npmjs.com/package/icore/v/1.0.1
-[1.0.0]: https://www.npmjs.com/package/icore/v/1.0.0
-[1.0.0-alpha]: https://www.npmjs.com/package/icore/v/1.0.0-alpha
-[0.1.38]: https://www.npmjs.com/package/icore/v/0.1.38
-[0.0.37 and earlier]: https://www.npmjs.com/package/icore?activeTab=versions