@loomcli/core 0.5.0 → 0.7.0

package/NOTICE

@@ -0,0 +1,34 @@
+@loomcli/core
+
+This package includes material from uucode and from the Unicode Character
+Database. Its license field reads "MIT AND Unicode-3.0": the Unicode tables
+named below stay under the Unicode License v3, and every other file is under
+the MIT License in LICENSE or, for the ported width iterator, in
+licenses/uucode-LICENSE.md. Neither license asks anything of an application
+that installs this package beyond keeping these notices with the files they
+cover.
+
+Unicode Character Database
+Copyright © 1991-2025 Unicode, Inc.
+Licensed under the Unicode License v3.
+A copy of the License is in licenses/unicode-LICENSE.txt, and at
+https://www.unicode.org/license.txt
+
+uucode
+Copyright (c) 2026 Tim Culverhouse
+Licensed under the MIT License.
+A copy of the License is in licenses/uucode-LICENSE.md.
+Source: @rockorager/uucode 2.2.1 on npm
+
+The Unicode tables core measures text with, in dist/unicode.generated.js, are
+generated by the Loom repository's scripts/generate-unicode-tables.mjs from
+the data files of @rockorager/uucode 2.2.1, which derive from Unicode 17 data.
+The generator writes the same values as a JavaScript module, so a bundle
+carries them.
+
+The grapheme width iterator in dist/style-width.js is ported from the
+@rockorager/uucode 2.2.1 width module. Changes made to it:
+
+- It is written in TypeScript and reads the generated tables module.
+- It yields each grapheme's start, end, and width, and no longer yields the
+  grapheme's text or offers clone, peek, or a standalone string width.

package/dist/application.d.ts

@@ -1,10 +1,11 @@
-import type { AfterAction, AttachmentConstraint, AfterArgument, AfterCommand, AfterResult, Command, CommandMethod, CommandNodeHandle, CommandState, ResultMethod } from './command.js';
+import type { AfterAction, AttachmentConstraint, AfterArgument, AfterCommand, AfterResult, ChildOwner, Command, CommandMethod, CommandNodeHandle, CommandState, ResultMethod } from './command.js';
 import type { ApplicationEnvironment, applicationEnvironment } from './environment.js';
 import type { ExtensionValue } from './extension.js';
 import type { GlobalsState } from './globals.js';
 import type { CommandGraph } from './inspect.js';
 import type { BuiltPlugin, Plugin } from './plugin.js';
 import type { RenderingPolicy } from './rendering.js';
+import type { Translation, TranslatorRegistry } from './translators.js';
 import type { Action, ArgumentConfig, ArgumentValue, declaredTypes, DeclaredTypes, DefaultConstraint, GlobalNameConstraint, GlobalOmissionConstraint, PerValueConstraint, NameConstraint, ExitCode, OptionConfig, OptionValue, ResultViews, ResultViewsOf, RowViews, RunOptions, ValidateOmittedConstraint } from './types.js';
 import type { ViewContributions, ViewOverride } from './view.js';
 /**
@@ -14,9 +15,20 @@ import type { ViewContributions, ViewOverride } from './view.js';
  * to no bare token, so it has no name to alias.
  */
 export type ApplicationMethod = Exclude<CommandMethod, 'alias'> | 'globalOption';
+/**
+ * The build fact file, `loom.packet.json`, that the entry imports and hands to the Application.
+ * `build` is typed `string`, because a JSON module types its members that way, and the Application
+ * constructor accepts `development` or `distributed` alone. Core ignores every other member.
+ */
+export interface Packet {
+    readonly build: string;
+}
 export interface ApplicationOptions<Plugins extends readonly Plugin[] = readonly Plugin[]> {
     rendering?: RenderingPolicy;
+    /** The packet that says whether this is a development build. With none, it is distributed. */
+    packet?: Packet;
     views?: readonly ViewOverride[];
+    translators?: readonly Translation[];
     plugins?: Plugins;
     extensions?: readonly ExtensionValue<'command'>[];
     description?: string;
@@ -29,13 +41,17 @@ export interface ApplicationOptions<Plugins extends readonly Plugin[] = readonly
 interface ApplicationConfig {
     /** Whether the application's own `command()` or `action()` has run, which closes `globalOption()`. */
     composed: boolean;
+    /** Whether the packet reads `development`, read once at construction. */
+    development: boolean;
     /** Each installed plugin's view contributions, in installation order. */
     contributors: readonly ViewContributions[];
     facts: ApplicationFacts;
     /** The parent that claimed each node the graph holds, so one value attaches at one point. */
-    owners: ReadonlyMap<CommandNodeHandle, string | null>;
+    owners: ReadonlyMap<CommandNodeHandle, ChildOwner>;
     plugins: readonly BuiltPlugin[];
     rendering: RenderingPolicy;
+    /** The application's translations, then each installed plugin's, in resolution order. */
+    translators: TranslatorRegistry;
     /** The application's own view overrides. */
     views: ViewContributions;
 }