@molecule/app-icons 1.0.0

package/LICENSE

@@ -0,0 +1,115 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions
+      to that Work, that is intentionally submitted to the Licensor for
+      inclusion in the Work by the copyright owner or by an individual or
+      Legal Entity authorized to submit on behalf of the copyright owner.
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event and under no legal theory shall
+      any Contributor be liable to You for damages.
+
+   9. Accepting Warranty or Additional Liability.
+
+   Copyright 2026 Molecule Dev, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Framework-agnostic icon set interfaces for molecule.dev.
+ *
+ * Icon set bond packages (e.g. `@molecule/app-icons-molecule`) export an
+ * `IconSet` object which is bonded via {@link setIconSet} at application
+ * startup. Application code retrieves icons via {@link getIcon} /
+ * {@link getIconDataUrl}, both of which call {@link getIconSet} internally.
+ *
+ * @example
+ * ```typescript
+ * import { setIconSet, getIconDataUrl } from '@molecule/app-icons'
+ * import { iconSet } from '@molecule/app-icons-molecule'
+ *
+ * setIconSet(iconSet)   // once, at app startup — before anything renders an icon
+ *
+ * // In components, prefer your framework UI's Icon component
+ * // (e.g. <Icon name="check-circle" /> from the app's UI bundle), which reads
+ * // the bonded set. For CSS/background/favicon contexts:
+ * const url = getIconDataUrl('check-circle', '#16a34a')
+ * ```
+ *
+ * @remarks
+ * - **Bond the icon set before first render** — `getIcon()`/`getIconDataUrl()` (and
+ *   any `Icon` component built on them) throw until `setIconSet()` has run; wire it
+ *   in the app's bond setup, not lazily inside a component.
+ * - Icon names are kebab-case (`'arrow-right'`, `'x-mark'`) and type-checked against
+ *   `IconName`. Don't invent names: an unknown name is a runtime error, not a blank.
+ *   App-specific glyphs are added by merging `IconData` into the bonded set and
+ *   augmenting `CustomIconNames` (see that interface) — never by inlining raw SVG
+ *   per call site.
+ * - Icons are decorative by default — pair them with accessible text
+ *   (`t('key', values, { defaultValue })` labels or `aria-label`), never as the only
+ *   carrier of meaning.
+ *
+ * @module
+ */
+export * from './provider.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * Framework-agnostic icon set interfaces for molecule.dev.
+ *
+ * Icon set bond packages (e.g. `@molecule/app-icons-molecule`) export an
+ * `IconSet` object which is bonded via {@link setIconSet} at application
+ * startup. Application code retrieves icons via {@link getIcon} /
+ * {@link getIconDataUrl}, both of which call {@link getIconSet} internally.
+ *
+ * @example
+ * ```typescript
+ * import { setIconSet, getIconDataUrl } from '@molecule/app-icons'
+ * import { iconSet } from '@molecule/app-icons-molecule'
+ *
+ * setIconSet(iconSet)   // once, at app startup — before anything renders an icon
+ *
+ * // In components, prefer your framework UI's Icon component
+ * // (e.g. <Icon name="check-circle" /> from the app's UI bundle), which reads
+ * // the bonded set. For CSS/background/favicon contexts:
+ * const url = getIconDataUrl('check-circle', '#16a34a')
+ * ```
+ *
+ * @remarks
+ * - **Bond the icon set before first render** — `getIcon()`/`getIconDataUrl()` (and
+ *   any `Icon` component built on them) throw until `setIconSet()` has run; wire it
+ *   in the app's bond setup, not lazily inside a component.
+ * - Icon names are kebab-case (`'arrow-right'`, `'x-mark'`) and type-checked against
+ *   `IconName`. Don't invent names: an unknown name is a runtime error, not a blank.
+ *   App-specific glyphs are added by merging `IconData` into the bonded set and
+ *   augmenting `CustomIconNames` (see that interface) — never by inlining raw SVG
+ *   per call site.
+ * - Icons are decorative by default — pair them with accessible text
+ *   (`t('key', values, { defaultValue })` labels or `aria-label`), never as the only
+ *   carrier of meaning.
+ *
+ * @module
+ */
+export * from './provider.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Icon set bond accessor and icon lookup functions.
+ *
+ * Icon set bond packages (e.g. `@molecule/app-icons-molecule`) export an
+ * `IconSet` object which is bonded via `setIconSet()`. Application code
+ * uses `getIcon()` or `getIconDataUrl()` to retrieve individual icons.
+ *
+ * @module
+ */
+import type { IconData, IconName, IconSet } from './types.js';
+/**
+ * Registers an icon set as the active singleton. Called at application
+ * startup to wire an icon library.
+ *
+ * @param iconSet - The icon set (a record of icon names to icon data).
+ */
+export declare function setIconSet(iconSet: IconSet): void;
+/**
+ * Retrieves the bonded icon set, throwing if none is configured.
+ *
+ * @returns The bonded icon set.
+ * @throws {Error} If no icon set has been bonded — names {@link setIconSet}
+ *   and a concrete icon set bond package as the fix, rather than the generic
+ *   `@molecule/app-bond` "no provider bonded" message.
+ */
+export declare function getIconSet(): IconSet;
+/**
+ * Checks whether an icon set is currently bonded.
+ *
+ * @returns `true` if an icon set is bonded.
+ */
+export declare function hasIconSet(): boolean;
+/**
+ * Retrieves a single icon by name from the bonded icon set.
+ *
+ * @param name - The icon name to look up.
+ * @returns The icon data (paths, viewBox, stroke/fill attributes).
+ * @throws {Error} If no icon set is bonded or the icon name is not found.
+ */
+export declare function getIcon(name: IconName): IconData;
+/**
+ * Generates a CSS `url()` data URI containing an inline SVG for an icon.
+ * Useful for `backgroundImage` styling of native elements (e.g. `<select>`
+ * dropdown arrows) where SVG elements cannot be inserted.
+ *
+ * @param name - The icon name to render.
+ * @param color - The stroke/fill color for the SVG (defaults to `'#6b7280'`).
+ * @returns A CSS `url("data:image/svg+xml,...")` string.
+ */
+export declare function getIconDataUrl(name: IconName, color?: string): string;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAI7D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAWpC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAahD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,SAAY,GAAG,MAAM,CAmCxE"}

package/dist/provider.js

@@ -0,0 +1,110 @@
+/**
+ * Icon set bond accessor and icon lookup functions.
+ *
+ * Icon set bond packages (e.g. `@molecule/app-icons-molecule`) export an
+ * `IconSet` object which is bonded via `setIconSet()`. Application code
+ * uses `getIcon()` or `getIconDataUrl()` to retrieve individual icons.
+ *
+ * @module
+ */
+import { bond, get as bondGet, isBonded } from '@molecule/app-bond';
+import { t } from '@molecule/app-i18n';
+const BOND_TYPE = 'icon-set';
+/**
+ * Registers an icon set as the active singleton. Called at application
+ * startup to wire an icon library.
+ *
+ * @param iconSet - The icon set (a record of icon names to icon data).
+ */
+export function setIconSet(iconSet) {
+    bond(BOND_TYPE, iconSet);
+}
+/**
+ * Retrieves the bonded icon set, throwing if none is configured.
+ *
+ * @returns The bonded icon set.
+ * @throws {Error} If no icon set has been bonded — names {@link setIconSet}
+ *   and a concrete icon set bond package as the fix, rather than the generic
+ *   `@molecule/app-bond` "no provider bonded" message.
+ */
+export function getIconSet() {
+    const iconSet = bondGet(BOND_TYPE);
+    if (!iconSet) {
+        throw new Error(t('icons.error.noProvider', undefined, {
+            defaultValue: '@molecule/app-icons: No icon set bonded. Call setIconSet() with an IconSet (e.g. the export from @molecule/app-icons-molecule).',
+        }));
+    }
+    return iconSet;
+}
+/**
+ * Checks whether an icon set is currently bonded.
+ *
+ * @returns `true` if an icon set is bonded.
+ */
+export function hasIconSet() {
+    return isBonded(BOND_TYPE);
+}
+/**
+ * Retrieves a single icon by name from the bonded icon set.
+ *
+ * @param name - The icon name to look up.
+ * @returns The icon data (paths, viewBox, stroke/fill attributes).
+ * @throws {Error} If no icon set is bonded or the icon name is not found.
+ */
+export function getIcon(name) {
+    const iconSet = getIconSet();
+    const icon = iconSet[name];
+    if (!icon) {
+        throw new Error(t('icons.error.notFound', { name }, { defaultValue: `Icon "${name}" not found in the current icon set.` }));
+    }
+    return icon;
+}
+/**
+ * Generates a CSS `url()` data URI containing an inline SVG for an icon.
+ * Useful for `backgroundImage` styling of native elements (e.g. `<select>`
+ * dropdown arrows) where SVG elements cannot be inserted.
+ *
+ * @param name - The icon name to render.
+ * @param color - The stroke/fill color for the SVG (defaults to `'#6b7280'`).
+ * @returns A CSS `url("data:image/svg+xml,...")` string.
+ */
+export function getIconDataUrl(name, color = '#6b7280') {
+    const icon = getIcon(name);
+    const viewBox = icon.viewBox || '0 0 20 20';
+    const fill = icon.fill || 'currentColor';
+    const encodedColor = encodeURIComponent(color);
+    const pathsSvg = icon.svg
+        ? icon.svg
+        : icon.paths
+            .map((p) => {
+            const attrs = [`d='${p.d}'`];
+            if (p.fill)
+                attrs.push(`fill='${encodeURIComponent(p.fill)}'`);
+            if (p.fillRule)
+                attrs.push(`fill-rule='${p.fillRule}'`);
+            if (p.clipRule)
+                attrs.push(`clip-rule='${p.clipRule}'`);
+            if (p.opacity !== undefined)
+                attrs.push(`opacity='${p.opacity}'`);
+            return `<path ${attrs.join(' ')} />`;
+        })
+            .join('');
+    const svgAttrs = [`xmlns='http://www.w3.org/2000/svg'`, `viewBox='${viewBox}'`];
+    if (icon.stroke || fill === 'none') {
+        svgAttrs.push(`fill='none'`);
+        svgAttrs.push(`stroke='${encodedColor}'`);
+        if (icon.strokeWidth)
+            svgAttrs.push(`stroke-width='${icon.strokeWidth}'`);
+        if (icon.strokeLinecap)
+            svgAttrs.push(`stroke-linecap='${icon.strokeLinecap}'`);
+        if (icon.strokeLinejoin)
+            svgAttrs.push(`stroke-linejoin='${icon.strokeLinejoin}'`);
+    }
+    else {
+        svgAttrs.push(`fill='${encodedColor}'`);
+    }
+    const svg = `<svg ${svgAttrs.join(' ')}>${pathsSvg}</svg>`;
+    const encoded = svg.replace(/</g, '%3c').replace(/>/g, '%3e').replace(/#/g, '%23');
+    return `url("data:image/svg+xml,${encoded}")`;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Icon set interfaces for molecule.dev.
+ *
+ * @module
+ */
+/** Single SVG path element data. */
+export interface IconPath {
+    d: string;
+    fill?: string;
+    fillRule?: 'evenodd' | 'nonzero';
+    clipRule?: 'evenodd' | 'nonzero';
+    opacity?: number;
+}
+/** Complete icon definition — framework-agnostic SVG data. */
+export interface IconData {
+    /** SVG path elements. */
+    paths: IconPath[];
+    /** viewBox attribute. Default: "0 0 20 20" */
+    viewBox?: string;
+    /** fill attribute. Default: "currentColor" */
+    fill?: string;
+    /** stroke attribute (for outlined icons). */
+    stroke?: string;
+    /** strokeWidth for outlined icons. */
+    strokeWidth?: number;
+    /** strokeLinecap for outlined icons. */
+    strokeLinecap?: 'round' | 'butt' | 'square';
+    /** strokeLinejoin for outlined icons. */
+    strokeLinejoin?: 'round' | 'miter' | 'bevel';
+    /** Raw inner SVG content for complex icons that can't be represented as paths alone. */
+    svg?: string;
+}
+/** A named set of icons. */
+export interface IconSet {
+    [name: string]: IconData;
+}
+/**
+ * Augmentable registry of extra icon names beyond {@link ComponentIconName}.
+ *
+ * An icon set bond (or an app merging custom glyphs into the bonded set) that
+ * provides names beyond the required contract declares them here so
+ * `getIcon()` / `<Icon name="…" />` accept them type-safely:
+ *
+ * ```typescript
+ * declare module '@molecule/app-icons' {
+ *   interface CustomIconNames {
+ *     'my-custom-glyph': true
+ *   }
+ * }
+ * ```
+ *
+ * Keys are icon names; values are always `true` (the interface is a name
+ * registry, never instantiated).
+ */
+export interface CustomIconNames {
+}
+/**
+ * Every icon name known to the type system: the {@link ComponentIconName}
+ * contract every icon set must provide, plus any {@link CustomIconNames}
+ * augmentations. Use this for `getIcon()` arguments and `icon`/`name` props so
+ * a typo fails the type-check instead of throwing at render time.
+ */
+export type IconName = ComponentIconName | (keyof CustomIconNames & string);
+/**
+ * Icons required by UI components.
+ * All icon set providers MUST include these.
+ */
+export type ComponentIconName = 'info-circle' | 'check-circle' | 'exclamation-triangle' | 'x-circle' | 'x-mark' | 'arrow-left' | 'arrow-right' | 'arrow-up' | 'arrow-down' | 'chevron-left' | 'chevron-right' | 'chevron-up' | 'chevron-down' | 'chevrons-left' | 'chevrons-right' | 'chevrons-up-down' | 'search' | 'plus' | 'minus' | 'check' | 'pencil' | 'trash' | 'copy' | 'download' | 'upload' | 'share' | 'link' | 'link-external' | 'filter' | 'sort-asc' | 'sort-desc' | 'sync' | 'ellipsis-horizontal' | 'eye' | 'eye-closed' | 'gear' | 'lock' | 'unlock' | 'home' | 'globe' | 'menu' | 'maximize' | 'minimize' | 'user' | 'people' | 'sign-in' | 'sign-out' | 'sun' | 'moon' | 'bell' | 'file' | 'folder' | 'calendar' | 'clock' | 'history' | 'tag' | 'star' | 'heart' | 'code' | 'mail' | 'bug' | 'lightbulb' | 'mention' | 'microphone' | 'paperclip' | 'question' | 'bookmark' | 'pin' | 'reply' | 'image' | 'table' | 'thumbsup' | 'thumbsdown' | 'logo-mark' | 'logo-dot' | 'github' | 'google' | 'gitlab' | 'twitter';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAChC,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;IAC3C,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IAC5C,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,4BAA4B;AAC5B,MAAM,WAAW,OAAO;IACtB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,eAAe;CAAG;AAEnC;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,CAAA;AAE3E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAEzB,aAAa,GACb,cAAc,GACd,sBAAsB,GACtB,UAAU,GAEV,QAAQ,GAER,YAAY,GACZ,aAAa,GACb,UAAU,GACV,YAAY,GAEZ,cAAc,GACd,eAAe,GACf,YAAY,GACZ,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAElB,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,MAAM,GACN,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,GACN,eAAe,GACf,QAAQ,GACR,UAAU,GACV,WAAW,GACX,MAAM,GAEN,qBAAqB,GACrB,KAAK,GACL,YAAY,GACZ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,UAAU,GACV,UAAU,GAEV,MAAM,GACN,QAAQ,GACR,SAAS,GACT,UAAU,GAEV,KAAK,GACL,MAAM,GAEN,MAAM,GAEN,MAAM,GACN,QAAQ,GACR,UAAU,GACV,OAAO,GACP,SAAS,GACT,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GAEN,KAAK,GACL,WAAW,GACX,SAAS,GACT,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,YAAY,GAEZ,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,CAAA"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Icon set interfaces for molecule.dev.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@molecule/app-icons",
+  "version": "1.0.0",
+  "description": "Icon set interfaces for molecule.dev",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "icons",
+    "interfaces"
+  ],
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@molecule/app-bond": "^1.0.0",
+    "@molecule/app-i18n": "^1.0.0"
+  },
+  "devDependencies": {
+    "@molecule/app-bond": "1.0.0",
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/core/icons"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/app/core/icons",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}