@ui0/icon 0.0.0-stage → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,218 @@
+/**
+ * 🆑  icon Component
+ *     icon.types.d.ts
+ */
+import type { Indexed } from '@ui0/types';
+import { type App, type Component, type ConcreteComponent } from 'vue';
+/** color reference a paint prop accepts - pool names plus ramp steps */
+export type ComponentSchemedColor = string;
+/** stroke weight like font-weight */
+export type ComponentWeight = number;
+/** control size token */
+export type ControlSize = string;
+/** 'pack/icon.modifiers?params' query identifying an icon */
+export type IconQuery = string;
+/** component exposing an `icon` slot value */
+export interface Iconable {
+    icon: IconQuery;
+}
+export interface IconProgressOptions {
+    direction?: 'radial-cw' | 'radial-ccw' | 'step';
+}
+export interface SizeProps {
+    size?: ControlSize;
+    width?: number | string;
+    height?: number | string;
+}
+export interface ColorProps {
+    color?: ComponentSchemedColor | ComponentSchemedColor[];
+}
+export type IconFit = 'default' | 'small' | 'large';
+export type IconShape = 'ellipse-rect' | 'rect' | 'circle' | 'pentagon' | 'hexagon' | 'heptagon' | 'octagon' | 'shield';
+export type IconDisplay = 'inline' | 'block';
+export type IconRendering = 'original' | 'monochrome' | 'layers' | 'layers-shift' | 'multicolor';
+export type IconWeight = ComponentWeight;
+export type IconName = IconQuery;
+export interface IconBodyOptions {
+    flags: IconBodyOptionsFlag[];
+    modifiers: Set<string>;
+    layers: Set<string>;
+    paintNodesCount: number;
+}
+export interface IconConfig extends Indexed {
+    icons: Indexed<IconIconConfig>;
+    useWeight?: boolean;
+    fillable?: boolean;
+    badge: IconBadgeOptions;
+    viewBox: string;
+}
+export interface IconIconConfig extends Indexed {
+    badge?: IconBadgeOptions;
+    progress?: IconProgressOptions;
+}
+export interface IconPack extends Record<string, Component> {
+}
+export interface IconPlugin {
+    components: IconPack;
+    names: string[];
+    name: string;
+    config: IconConfig;
+}
+export type IconBodyOptionsFlag = 'accent' | 'progress' | 'animation' | 'modifiers' | 'no-fit' | 'no-rescale' | 'no-fill' | 'no-cap' | 'no-join' | 'no-stroke' | 'always-stroke' | 'always-fill' | 'no-process-stroke' | 'composed' | string;
+export interface IconCompositionProps {
+}
+export interface IconBadgeProps extends Omit<IconProps, 'badge' | 'size' | 'display' | 'width' | 'height' | 'density'> {
+    value?: string;
+}
+export interface IconCanvasProps extends IconProps {
+    masked?: boolean;
+}
+export interface BoxAttrs {
+    x?: string;
+    y?: string;
+    width?: string;
+    height?: string;
+}
+export type IconInternalComponent = ConcreteComponent & {
+    customOptions: IconBodyOptions;
+};
+export interface IconMinimalProps {
+    value?: string;
+    pack?: string;
+    color?: string;
+    shape?: IconShape;
+    modifiers?: string | string[];
+    fit?: 'default' | 'small' | 'large';
+    rendering?: 'original' | 'monochrome' | 'layers' | 'layers-shift' | 'multicolor';
+}
+export interface IconProps extends ColorProps, SizeProps {
+    /**
+     * Icon animations
+     */
+    /**
+     * badge
+     */
+    badge?: IconQuery | IconBadgeProps;
+    /**
+     * display mode
+     * @example 'inline' | 'block'
+     */
+    display?: IconDisplay;
+    /**
+     * Render with shape
+     */
+    shape?: IconShape;
+    /**
+     *  Icon Modifiers
+     */
+    modifiers?: string[] | string;
+    /**
+     * Set progress
+     * @default 100
+     */
+    progress?: number | string;
+    /**
+     * Flip icon horizontally
+     */
+    flipped?: boolean;
+    /**
+     * Icon view box fit
+     * @default 'default'
+     */
+    fit?: IconFit;
+    /**
+     * IconOptions
+     */
+    options?: IconOptions;
+    /**
+     * Set a pack of icons
+     */
+    pack?: string;
+    /**
+     * Rotate icon degrees
+     */
+    rotate?: number | string;
+    /**
+     * Icon rendering method
+     */
+    rendering?: IconRendering;
+    size?: ControlSize;
+    /**
+     * Title for accessibility
+     */
+    title?: string;
+    /**
+     * Icon identifier
+     * @example 'cancel' | 'arrow-rotate' | 'pin?color=error'
+     */
+    value?: Iconable['icon'];
+    /**
+     * Controls icon thickness/saturation (similar to font-weight)
+     * @default 400
+     * @range 100-900
+     */
+    weight?: IconWeight;
+    /**
+     * Custom width
+     */
+    width?: number | string;
+    /**
+     * Custom height
+     */
+    height?: number | string;
+}
+export interface IconDefaults extends IconProps {
+    display: IconDisplay;
+    progress: number | undefined;
+    weight: number;
+    pack: string;
+    value: IconQuery;
+    rotate: number;
+    fit: IconFit;
+    modifiers: string[];
+    color: ComponentSchemedColor[];
+}
+type IconCellPos = '0' | '1' | '2' | '3';
+export interface IconBadgeOptions {
+    cell?: `${IconCellPos} ${IconCellPos}`;
+    x?: number | 'start' | 'end' | 'center';
+    y?: number | 'start' | 'end' | 'center';
+    scale?: 'full' | 'large' | 'normal' | 'small' | number;
+    showMask?: boolean;
+}
+export interface IconOptions extends Indexed {
+    /**
+     * Icon badge options
+     */
+    badge?: IconBadgeOptions;
+    progress?: {
+        direction?: boolean;
+    };
+    guides?: boolean;
+}
+export type IconDataIcon = string;
+export type IconDataProgress = 'step' | 'radial';
+export interface IconImpl {
+    icons: readonly string[];
+    vueApp: App | undefined;
+    packs: Record<string, IconPack>;
+    addPack: (plugin: IconPlugin) => void;
+    add: (name: string, component: Component) => void;
+    setVue: (app: App) => void;
+    list: (pack?: string) => string[];
+}
+declare global {
+    interface Ui0ComponentsProps {
+        icon: IconProps;
+    }
+    interface Ui0ComponentsDefaults {
+        icon: IconDefaults;
+    }
+    interface Ui0Components {
+        icon: {
+            props: IconProps;
+        };
+    }
+}
+export {};
+//# 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":"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"}

package/dist/ui0/index.d.ts

@@ -0,0 +1,8 @@
+import type { IconFramework } from '../framework';
+/**
+ * @returns framework services backed by the active ui0 core/theme instances
+ * (both absent outside a ui0 host - the icon then falls back to its built-in
+ * defaults, same as standalone usage)
+ */
+export declare function createUi0IconFramework(): IconFramework;
+//# sourceMappingURL=index.d.ts.map

package/dist/ui0/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui0/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,aAAa,CAatD"}

package/dist/ui0/index.js

@@ -0,0 +1,19 @@
+import { getComponentDefaults as r } from "@ui0/core";
+import { useTheme as n, useThemeContext as i } from "@ui0/theme";
+import { getCurrentInstance as u } from "vue";
+function f() {
+  return {
+    useTheme: (e, t) => {
+      if (!n()) return;
+      const [, o] = i(e, t);
+      return o ?? void 0;
+    },
+    useDefaults: () => {
+      const e = u(), t = e == null ? void 0 : e.appContext.config.globalProperties.$ui0;
+      return r("icon", t) ?? {};
+    }
+  };
+}
+export {
+  f as createUi0IconFramework
+};

package/dist/util.d.ts

@@ -0,0 +1,33 @@
+import { type ConcreteComponent } from 'vue';
+import type { IconProps } from './types';
+interface ParsedIconQuery {
+    modifiers: string[];
+    params: Record<string, string>;
+    getComponentName: () => string;
+    getComponent: () => ConcreteComponent | null;
+}
+/**
+ * Parses icon query string into structured object
+ *
+ * @example
+ * 'ui0-pack/icon.mod1.mod2?param=value' => {
+ *   pack: 'ui0-pack',
+ *   name: 'icon',
+ *   modifiers: ['mod1', 'mod2'],
+ *   params: { param: 'value' }
+ * }
+ */
+export declare function parseIconQuery(query: string, defaults: IconProps): ParsedIconQuery;
+/**
+ * Parses icon query string with default props fallback. Defaults fill only
+ * the keys the query itself did not set - an explicit query always wins
+ * (a 'blocks/arrow' pack address must not be clobbered by the configured
+ * default pack, etc).
+ *
+ * @param query - Icon query string
+ * @param defaults - Default icon props
+ * @returns Parsed query with defaults
+ */
+export declare function parseIconQueryLazy(query: string, defaults: IconProps): ParsedIconQuery;
+export {};
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAoB,MAAM,KAAK,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,gBAAgB,EAAE,MAAM,MAAM,CAAA;IAC9B,YAAY,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAA;CAC7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,eAAe,CAqClF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,eAAe,CAkBtF"}

package/dist/vite/blocks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The built-in `blocks` pack - raw template icons embedded in the bundle
+ * (imported as `?raw`, no file paths involved). The loader resolves
+ * 'blocks/<name>' against this registry out of the box; the consumer only
+ * references the icons from their own compositions and knows nothing about
+ * where they come from. Not part of the public API.
+ */
+export declare const blocks: Record<string, string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/vite/blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/blocks/index.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQzC,CAAA"}

package/dist/vite/compose.d.ts

@@ -0,0 +1,68 @@
+import { type IconVirtualCell, type IconVirtualIcon } from './types';
+/** the icon canvas is always a square; grids divide it into cell rects */
+/**
+ * The icon canvas conventions, fixed by the authoring template
+ * (packages/icon/src/vite/template-grid.svg):
+ * - the stroke-safe area spans 90..810 (a 720 square) on the canvas -
+ *   icon bodies live inside it, the margins take badge/overflow
+ * - grids divide the safe area into equal cells; every cell has a guttered
+ *   inner form (CELL: inner = pitch * 8/9, centered) and a full-pitch form
+ *   (CELL-FULL) for bleeding or filled parts
+ */
+export declare const SAFE_AREA = 90;
+export declare const SAFE_SIZE = 720;
+/** inner-cell factor: a CELL occupies 8/9 of its pitch, centered */
+export declare const CELL_INNER: number;
+export interface CellRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** the CELL-FULL rect of a 1-based 'row-col' cell inside a rows x cols grid */
+export declare function cellRect(rows: number, cols: number, cell: IconVirtualCell): CellRect;
+/** the guttered CELL rect: pitch * 8/9, centered inside the full cell */
+export declare function innerRect(rect: CellRect): CellRect;
+/** icon sources are authored on a 960 canvas (bodies inside the safe area) */
+export declare const ICON_CANVAS = 960;
+export interface ParsedVirtualValue {
+    /** icon name without pack prefix, cell address and query */
+    name: string;
+    cell?: IconVirtualCell;
+    query?: string;
+    /** state modifiers ('pie-90.fill.in:hover' -> ['fill', 'in-hover']) */
+    modifiers?: string[];
+}
+/** 'ui0/chart#1-2?weight=800' -> { name: 'ui0/chart', cell: '1-2', query: '?weight=800' } */
+export declare function parseVirtualValue(raw: string): ParsedVirtualValue;
+/**
+ * Extract the subtree marked `<g data-cell="row-col">` from a template sheet.
+ * Returns the part markup (data-cell attribute stripped) and the part's rect
+ * inside the sheet canvas, so the composer can map it into the target cell.
+ */
+export declare function extractTemplatePart(svg: string, cell: IconVirtualCell, rows: number, cols: number): {
+    markup: string;
+    rect: CellRect;
+} | undefined;
+/**
+ * Transform string placing a rect-sized item (template part or scaled icon)
+ * into the target cell: contain-scaled, centered, rotated about the cell
+ * center. `rotate` 90/270 swap the item's axes before fitting, so a 1x3
+ * template fills a 3x1 cell exactly.
+ */
+export declare function placementTransform(target: CellRect, item: CellRect, rotate?: number, fitScale?: number): string;
+export interface ResolvedSource {
+    /** the registry definition when the source is a template or another composition */
+    def?: import('./types').IconVirtualTemplate | IconVirtualIcon | undefined;
+    /** raw svg content for file-backed sources (templates and pack icons) */
+    svg?: string;
+    /** resolution warning, surfaced once per source by the caller */
+    warning?: string;
+}
+export type VirtualSourceResolver = (name: string) => ResolvedSource | undefined;
+/**
+ * Compose a virtual icon into a plain svg string (the regular transformer
+ * pipeline then turns it into an icon component). Recursion is cycle-guarded.
+ */
+export declare function composeVirtual(name: string, def: IconVirtualIcon, resolve: VirtualSourceResolver, seen?: Set<string>): string;
+//# sourceMappingURL=compose.d.ts.map

package/dist/vite/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/vite/compose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,eAAe,EAAE,KAAK,eAAe,EAA0B,MAAM,SAAS,CAAA;AAG/G,0EAA0E;AAC1E;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,KAAK,CAAA;AAC3B,eAAO,MAAM,SAAS,MAAM,CAAA;AAC5B,oEAAoE;AACpE,eAAO,MAAM,UAAU,QAAQ,CAAA;AAE/B,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAKpF;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CASlD;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAcjE;AAwBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,SAAS,CAgBhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAsBrH;AAED,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,GAAG,CAAC,EAAE,OAAO,SAAS,EAAE,mBAAmB,GAAG,eAAe,GAAG,SAAS,CAAA;IACzE,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAA;AAEhF;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,MAAM,CAuER"}

package/dist/vite/index.d.ts

@@ -0,0 +1,6 @@
+import { type Plugin } from 'vite';
+import type { IconLoaderOptions } from './options';
+export * from './types';
+export type { IconLoaderFit, IconLoaderOptions } from './options';
+export default function ViteUi0Icon(options?: IconLoaderOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAA;AAKhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAOlD,cAAc,SAAS,CAAA;AACvB,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAKjE,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA+K3E"}