@luscious-garden/aster-icons 0.1.0 → 0.2.0

package/README.md

@@ -1,58 +1,51 @@
 # @luscious-garden/aster-icons
 
-Canonical portable TypeScript icon and collection definitions for Aster.
-
-The package depends only on `@luscious-garden/aster-core`. Every icon and collection has an isolated public
-subpath; no package-wide definition root is exported. `@luscious-garden/aster-icons/manifest` provides
-metadata-only discovery without loading complete definitions, while `@luscious-garden/aster-icons/dynamic`
-resolves identities asynchronously without eager catalogue evaluation. These runtime boundaries
-do not change npm acquisition: installing `@luscious-garden/aster-icons` acquires the complete published package.
-The package contains no renderer, framework, DOM, filesystem, Import, or global catalogue
-dependency.
-The example below assumes `@luscious-garden/aster-svg` is installed independently by the consumer.
-
-Install both packages for this example with
-`pnpm add @luscious-garden/aster-icons@0.1.0 @luscious-garden/aster-svg@0.1.0`.
-To use a definition without SVG rendering, install only `@luscious-garden/aster-icons`; it brings
-its compatible Core dependency.
-
-Canonical `*.icon.ts` and `*.collection.ts` modules are editable sources. Package builds
-deterministically synchronise their manifests, exact loader maps and stable public facades before
-compilation.
+Canonical portable Aster icons and collections, distributed through isolated public subpaths.
+The package brings its compatible Core dependency; it does not render markup.
+
+## Usage
+
+```sh
+pnpm add @luscious-garden/aster-icons
+```
+
+### Individual icons
 
 ```ts
-import { ArrowLeft } from "@luscious-garden/aster-icons/arrow-left";
-import { Svg } from "@luscious-garden/aster-svg";
+import { Camera } from "@luscious-garden/aster-icons/camera";
 
-const markup = Svg.render(ArrowLeft);
+const definition = Camera;
 ```
 
-Collections expose icons by typed local alias and provide an ordered list for iteration:
+Pass the definition to a renderer such as
+[SVG](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/svg/index.md).
+
+### Collections
+
+Access a collection's icons by alias or in their declared order:
 
 ```ts
-import { AmellusCollection } from "@luscious-garden/aster-icons/collections/amellus";
+import { Amellus } from "@luscious-garden/aster-icons/collections/amellus";
 
-const cameraMarkup = Svg.render(AmellusCollection.icons.camera);
-const collectionMarkup = AmellusCollection.members.map((icon) => Svg.render(icon));
+const camera = Amellus.icons.camera;
+const orderedIcons = Amellus.members;
 ```
 
-Both views contain the same canonical icon objects. Importing Amellus evaluates all its declared
-members even when only `.icons.camera` is read; import `@luscious-garden/aster-icons/camera` directly
-when only that icon is needed.
+See the
+[Collections guide](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/collections/index.md)
+for the contract and export-naming migration.
+
+Use an individual subpath when only one icon is needed; a collection import evaluates all its
+declared members. Installation acquires the complete package, independently of runtime imports.
 
-The [release notes](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/releases.md)
-describe migration from earlier candidates.
+## Documentation
 
-The package currently provides the accepted Amellus foundational collection. See the
-[canonical package documentation](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/index.md),
-[authoring workflow](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/workflow.md),
-[release notes](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/releases.md) and
-[Amellus collection authority](https://github.com/BlueLuscious/aster/blob/master/docs/en/collections/amellus/index.md).
+- [Package guide](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/index.md): definitions, collections, metadata discovery and dynamic loaders.
+- [Authoring](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/workflow.md): editable sources and generated distribution.
+- [Amellus](https://github.com/BlueLuscious/aster/blob/master/docs/en/collections/amellus/index.md): collection identity and visual rules.
+- [Version history](https://github.com/BlueLuscious/aster/blob/master/docs/en/packages/icons/releases/index.md): changes and migrations.
 
 ## Licence
 
-The software and documentation are licensed under [ISC](LICENSE). BlueLuscious-owned icon and
-collection artwork marked with `LicenseRef-Aster-Artwork-1.0` follows the separate
-[Aster Artwork Licence](ARTWORK-LICENCE.md), which permits commercial use in products but not
-sale of the artwork as a standalone asset. Other artwork retains its declared terms. Software
-and artwork may appear in the same `*.icon.ts` module.
+Software and documentation follow [ISC](LICENSE). Marked BlueLuscious-owned artwork follows the
+separate [Aster Artwork Licence](ARTWORK-LICENCE.md); other artwork retains its declared terms.

package/dist/collections/a/amellus/amellus.collection.d.ts

@@ -1,7 +1,7 @@
 /**
  * @description Canonical Amellus collection containing the foundational general-purpose icon set.
  */
-export declare const AmellusCollection: import("@luscious-garden/aster-core").CollectionDefinition<{
+export declare const Amellus: import("@luscious-garden/aster-core").CollectionDefinition<{
     arrowLeft: import("@luscious-garden/aster-core").IconDefinition;
     arrowRight: import("@luscious-garden/aster-core").IconDefinition;
     arrowUp: import("@luscious-garden/aster-core").IconDefinition;

package/dist/collections/a/amellus/amellus.collection.js

@@ -29,7 +29,7 @@ import { Warning } from "../../../glyphs/w/warning/warning.icon.js";
 /**
  * @description Canonical Amellus collection containing the foundational general-purpose icon set.
  */
-export const AmellusCollection = Collection.define({
+export const Amellus = Collection.define({
     identity: {
         name: "amellus",
     },

package/dist/generated/dynamic/index.d.ts

@@ -1,9 +1,11 @@
 import type { CollectionDefinitionLoaderMap, IconDefinitionLoaderMap } from "../../dynamic/contracts/index.js";
 /**
  * @description Immutable exact asynchronous loaders for distributed Aster icon definitions.
+ * @remarks Prototype-free lookup resolves absent keys without inherited fallback.
  */
 export declare const AsterIconLoaders: IconDefinitionLoaderMap;
 /**
  * @description Immutable exact asynchronous loaders for distributed Aster collections.
+ * @remarks Prototype-free lookup resolves absent keys without inherited fallback.
  */
 export declare const AsterCollectionLoaders: CollectionDefinitionLoaderMap;

package/dist/generated/dynamic/index.js

@@ -1,9 +1,10 @@
 // Generated by `pnpm --dir packages/icons run generate:catalogue`.
 // Canonical definition modules are the source of truth. Do not edit manually.
 /**
- * @description Immutable exact asynchronous loaders for distributed Aster icon definitions.
+ * @description Exact loader entries for distributed Aster icon definitions before immutable publication.
+ * @remarks The local object is exported only after prototype removal and freezing.
  */
-export const AsterIconLoaders = Object.freeze({
+const iconLoaders = {
     "aster/arrow-down": Object.freeze(() => import("../facades/icons/arrow-down.js").then(({ ArrowDown }) => ArrowDown)),
     "aster/arrow-left": Object.freeze(() => import("../facades/icons/arrow-left.js").then(({ ArrowLeft }) => ArrowLeft)),
     "aster/arrow-right": Object.freeze(() => import("../facades/icons/arrow-right.js").then(({ ArrowRight }) => ArrowRight)),
@@ -30,10 +31,23 @@ export const AsterIconLoaders = Object.freeze({
     "aster/star": Object.freeze(() => import("../facades/icons/star.js").then(({ Star }) => Star)),
     "aster/user": Object.freeze(() => import("../facades/icons/user.js").then(({ User }) => User)),
     "aster/warning": Object.freeze(() => import("../facades/icons/warning.js").then(({ Warning }) => Warning)),
-});
+};
+Object.setPrototypeOf(iconLoaders, null);
+/**
+ * @description Immutable exact asynchronous loaders for distributed Aster icon definitions.
+ * @remarks Prototype-free lookup resolves absent keys without inherited fallback.
+ */
+export const AsterIconLoaders = Object.freeze(iconLoaders);
+/**
+ * @description Exact loader entries for distributed Aster collections before immutable publication.
+ * @remarks The local object is exported only after prototype removal and freezing.
+ */
+const collectionLoaders = {
+    "amellus": Object.freeze(() => import("../facades/collections/amellus.js").then(({ Amellus }) => Amellus)),
+};
+Object.setPrototypeOf(collectionLoaders, null);
 /**
  * @description Immutable exact asynchronous loaders for distributed Aster collections.
+ * @remarks Prototype-free lookup resolves absent keys without inherited fallback.
  */
-export const AsterCollectionLoaders = Object.freeze({
-    "amellus": Object.freeze(() => import("../facades/collections/amellus.js").then(({ AmellusCollection }) => AmellusCollection)),
-});
+export const AsterCollectionLoaders = Object.freeze(collectionLoaders);

package/dist/generated/facades/collections/amellus.d.ts

@@ -1 +1 @@
-export { AmellusCollection } from "../../../collections/a/amellus/amellus.collection.js";
+export { Amellus } from "../../../collections/a/amellus/amellus.collection.js";

package/dist/generated/facades/collections/amellus.js

@@ -1,3 +1,3 @@
 // Generated by `pnpm --dir packages/icons run generate:catalogue`.
 // Canonical definition modules are the source of truth. Do not edit manually.
-export { AmellusCollection } from "../../../collections/a/amellus/amellus.collection.js";
+export { Amellus } from "../../../collections/a/amellus/amellus.collection.js";

package/dist/generated/manifest/index.js

@@ -378,7 +378,7 @@ export const AsterCollectionManifest = Object.freeze([
         identity: Object.freeze({
             name: "amellus",
         }),
-        symbol: "AmellusCollection",
+        symbol: "Amellus",
         metadata: Object.freeze({
             displayName: "Amellus",
             description: "Minimalist general-purpose outline icons for application interfaces.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luscious-garden/aster-icons",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Canonical portable Aster icon and collection definitions.",
   "type": "module",
   "author": "BlueLuscious",
@@ -43,7 +43,7 @@
     "dist"
   ],
   "dependencies": {
-    "@luscious-garden/aster-core": "^0.1.0"
+    "@luscious-garden/aster-core": "^0.1.1"
   },
   "scripts": {
     "build": "pnpm run generate:catalogue && pnpm run clean && tsc -p tsconfig.json",