@loomcli/core 0.6.0 → 0.8.0

package/dist/view.d.ts

@@ -56,7 +56,7 @@ interface FailureViewContext extends ViewContext {
 interface FailureView<Failure extends LoomError> {
     render: (failure: Readonly<Failure>, context: FailureViewContext) => string;
     /** A failure view has one shape, as a view does. */
-    row?: never;
+    row?: undefined;
 }
 /**
  * One stored view function, with the data type and the context erased. A registry holds one entry
@@ -125,17 +125,22 @@ declare class OverrideDeclaration {
 type ViewOverride = Pick<OverrideDeclaration, typeof viewOverride>;
 /** What a plugin's own list holds: the views it declares and the overrides it makes. */
 type ViewContribution = AnyDeclaredView | ViewOverride;
+/** Every value an override can key on: a declared view of either shape or a failure class. */
+type AnyOverrideKey = AnyDeclaredView | FailureClass<LoomError>;
 /**
- * One override pairing a key with a replacement view. Under a declared view the replacement is
- * typed from the view's data; under a failure class it is typed from the class's instances, which
- * is the typed path for a class-keyed list, because an array literal cannot carry a different type
- * parameter per element.
+ * The replacement view one key takes, derived from the key alone. The declared-view branches come
+ * first, so a declared view is never read as a failure class. Each check is wrapped in a tuple so a
+ * union key is not split into a union of replacements that each answer only one of its members.
  */
-declare function override<Data>(key: DeclaredView<Data>, replacement: NoInfer<View<Data>>): ViewOverride;
-declare function override<Row>(key: DeclaredRowView<Row>, replacement: NoInfer<RowView<Row>>): ViewOverride;
-declare function override<Failure extends LoomError>(key: FailureClass<Failure> & {
-    readonly [declaredView]?: never;
-}, replacement: NoInfer<FailureView<Failure>>): ViewOverride;
+type ReplacementView<Key> = [Key] extends [DeclaredView<infer Data>] ? View<Data> : [Key] extends [DeclaredRowView<infer Row>] ? RowView<Row> : [Key] extends [FailureClass<infer Failure>] ? FailureView<Failure> : never;
+/**
+ * One override pairing a key with a replacement view. The replacement's type is derived from the
+ * key: under a declared view it is typed from the view's data, and under a failure class from the
+ * class's instances, which is the typed path for a class-keyed list, because an array literal cannot
+ * carry a different type parameter per element. One signature serves every key, so a mismatch
+ * names the replacement's type against the one the key expects.
+ */
+declare function override<Key extends AnyOverrideKey>(key: Key, replacement: NoInfer<ReplacementView<Key>>): ViewOverride;
 /** One contributor's overrides, read once per build and consulted in contributor order. */
 interface ViewContributions {
     failures: Map<unknown, StoredView>;
@@ -210,5 +215,5 @@ type FailureReport = {
  * carries the same default text without hints, which the plain fallback path writes.
  */
 declare function describeFailure(registry: ViewRegistry, failure: LoomError, context: FailureViewContext): FailureReport;
-export type { AnyDeclaredView, DeclaredRowView, DeclaredView, DeclaredViewBrand, FailureClass, FailureReport, FailureView, FailureViewContext, ResolvedRowView, ViewContribution, ViewContributions, ViewSubject, ViewIdentities, ViewOverride, ViewRegistry, ViewShape, };
+export type { AnyDeclaredView, AnyOverrideKey, DeclaredRowView, DeclaredView, DeclaredViewBrand, FailureClass, FailureReport, FailureView, FailureViewContext, ReplacementView, ResolvedRowView, ViewContribution, ViewContributions, ViewSubject, ViewIdentities, ViewOverride, ViewRegistry, ViewShape, };
 export { buildViews, describeFailure, override, resolveRowView, resolveView, shapeOf, view, viewIdentities, };

package/dist/view.js

@@ -84,12 +84,21 @@ class OverrideDeclaration {
         Object.freeze(this);
     }
 }
+/**
+ * One override pairing a key with a replacement view. The replacement's type is derived from the
+ * key: under a declared view it is typed from the view's data, and under a failure class from the
+ * class's instances, which is the typed path for a class-keyed list, because an array literal cannot
+ * carry a different type parameter per element. One signature serves every key, so a mismatch
+ * names the replacement's type against the one the key expects.
+ */
 function override(key, replacement) {
+    // Every replacement a key derives is a stored view, so it widens here with no check.
+    const supplied = replacement;
     const stored = {
-        head: replacement.head,
-        render: replacement.render,
-        row: replacement.row,
-        tail: replacement.tail,
+        head: supplied.head,
+        render: supplied.render,
+        row: supplied.row,
+        tail: supplied.tail,
     };
     const declared = declarations.get(key);
     if (declared) {

package/licenses/unicode-LICENSE.txt

@@ -0,0 +1,41 @@
+https://www.unicode.org/license.txt
+
+UNICODE LICENSE V3
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 1991-2025 Unicode, Inc.
+
+NOTICE TO USER: Carefully read the following legal agreement. BY
+DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of data files and any associated documentation (the "Data Files") or
+software and any associated documentation (the "Software") to deal in the
+Data Files or Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, and/or sell
+copies of the Data Files or Software, and to permit persons to whom the
+Data Files or Software are furnished to do so, provided that either (a)
+this copyright and permission notice appear with all copies of the Data
+Files or Software, or (b) this copyright and permission notice appear in
+associated Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
+THIRD PARTY RIGHTS.
+
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
+BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA
+FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in these Data Files or Software without prior written
+authorization of the copyright holder.

package/licenses/uucode-LICENSE.md

@@ -0,0 +1,35 @@
+# uucode license
+
+MIT License
+
+Copyright (c) 2026 Tim Culverhouse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Attribution
+
+This TypeScript implementation is based on the design and table strategy of
+Jacob Sandlund's `uucode`:
+
+- https://github.com/jacobsandlund/uucode
+
+The bundled Unicode Character Database files are provided by Unicode, Inc. and
+are subject to the Unicode terms of use:
+
+- https://www.unicode.org/terms_of_use.html

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@loomcli/core",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "The Loom CLI core package. Provides the scaffolding for creating new Loom CLI applications.",
-  "license": "MIT",
+  "license": "MIT AND Unicode-3.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dbtlr/loomcli.git"
   },
   "files": [
     "dist",
-    "LICENSE"
+    "LICENSE",
+    "licenses",
+    "NOTICE"
   ],
   "type": "module",
   "exports": {
@@ -19,9 +21,11 @@
     }
   },
   "dependencies": {
-    "@rockorager/uucode": "2.2.1",
     "@standard-schema/spec": "^1.1.0",
-    "@types/node": "22.20.1"
+    "@types/node": "22.20.5"
+  },
+  "devDependencies": {
+    "@rockorager/uucode": "2.2.1"
   },
   "engines": {
     "bun": ">=1.4.0",