icore 1.0.13 → 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 CommandInput, type CommandName, type CommandRegistry, type CommandResolutionOptions, 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

@@ -78,10 +78,10 @@ type CommandDefinitionParts<TCommand extends AnyCommandDefinition> = TCommand ex
     metadata: TCommand['metadata'];
     payload: unknown;
 };
-type CommandContext<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['context'];
-type CommandResult<TCommand extends AnyCommandDefinition> = Awaited<CommandDefinitionParts<TCommand>['result']>;
+export type CommandContext<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['context'];
+export type CommandResult<TCommand extends AnyCommandDefinition> = Awaited<CommandDefinitionParts<TCommand>['result']>;
 type CommandSchema<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['schema'];
-type CommandPayload<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['payload'];
+export type CommandPayload<TCommand extends AnyCommandDefinition> = CommandDefinitionParts<TCommand>['payload'];
 /**
  * Infers the public command name from a command path.
  */
@@ -116,7 +116,7 @@ export type ResolvedCommand<TCommand extends AnyCommandDefinition> = {
 /**
  * Command resolved and validated without runtime context.
  */
-export type PreparedCommand<TCommand extends AnyCommandDefinition> = {
+export type PreparedCommand<TCommand extends AnyCommandDefinition> = TCommand extends AnyCommandDefinition ? {
     name: CommandName<TCommand>;
     path: TCommand['path'];
     command: TCommand;
@@ -124,7 +124,7 @@ export type PreparedCommand<TCommand extends AnyCommandDefinition> = {
     provided: InferProvidedOptions<CommandSchema<TCommand>>;
     positionals: string[];
     payload: CommandPayload<TCommand>;
-};
+} : never;
 /**
  * Defines a command while preserving literal option schema types.
  */
@@ -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 CommandInput, type CommandName, type CommandRegistry, type CommandResolutionOptions, 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.13",
+  "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,121 +0,0 @@
-# Changelog
-
-All notable user-facing changes to this package are documented here.
-
-This file was reconstructed from npm publish metadata and local git history.
-Older releases did not have a maintained changelog, so early entries are
-intentionally conservative.
-
-## 1.0.13 - 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 this changelog.
-
-### Changed
-
-- Boolean options reject explicit values such as `--flag=true` and `--flag=false`; use `--flag` and `--no-flag`.
-
-## 1.0.12 - 2026-07-02
-
-- Replaced the preliminary flag-only boolean option naming with `syntax: 'flag'`.
-- Documented flag-only boolean option behavior.
-
-## 1.0.11 - 2026-07-02
-
-- Added preliminary flag-only boolean option support.
-
-## 1.0.10 - 2026-07-02
-
-- Added two-phase command execution.
-- Added `PreparedCommandInput`.
-- Added `PreparedCommand`.
-- Added `prepareCommandFromArgs`.
-- Added `runPreparedCommand`.
-- Added command `metadata`.
-- Added command `prepare` hook.
-- Changed `runCommand` and `runCommandFromRegistry` to use the prepare-and-run flow internally.
-- Added focused tests for prepare-time validation and handler safety.
-
-## 1.0.9 - 2026-07-02
-
-- Refined npm package metadata.
-- Updated repository metadata for npm.
-- Simplified published package contents.
-
-## 1.0.8 - 2026-07-02
-
-- Updated package author metadata.
-- Normalized README heading structure.
-
-## 1.0.7 - 2026-07-02
-
-- Renamed README examples from `upper` to `uppercase`.
-- Cleaned duplicated command test coverage without changing public behavior.
-
-## 1.0.6 - 2026-07-02
-
-- 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
-
-- Rebuilt README as the main public documentation entry point.
-- Removed separate generated reference docs from the published documentation flow.
-
-## 1.0.4 - 2026-07-01
-
-- Reorganized README and documentation references.
-
-## 1.0.3 - 2026-07-01
-
-- Added README table of contents.
-- Polished README formatting and emphasis.
-
-## 1.0.2 - 2026-06-30
-
-- Clarified CLI scope and supported syntax in README.
-- Added module boundary comments to production source files.
-- Updated package description and keywords.
-
-## 1.0.1 - 2026-06-30
-
-- 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
-
-- 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.
-- Lowered the runtime Node.js engine to `>=16.9.0`.
-
-## 1.0.0-alpha - 2026-06-28
-
-- 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
-
-- Final legacy web-framework line release.
-- Added legacy tests and documentation.
-- Updated the legacy package description.
-- Trimmed legacy runtime dependencies.
-
-## 0.0.37 and earlier
-
-- Original legacy npm package line published between 2017 and 2019.
-- Legacy history is preserved for package provenance.
-- Detailed changelog entries were not maintained for these releases.