npm - @yoyaflow/yoya-ui - Versions diffs - 0.2.1 → 0.3.1 - Mend

@yoyaflow/yoya-ui 0.2.1 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@yoyaflow/yoya-ui",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "A browser-native JS UI library with declarative HTML authoring: component library, router, i18n, theming and layout, works with or without a build tool, SSR-ready.",
   "type": "module",
   "private": false,

package/types/core.d.ts CHANGED Viewed

@@ -450,6 +450,69 @@ export function vStateNode<S extends Record<string, unknown> = Record<string, un
   config: StateNodeConfig<S>
 ): StateNodeComponent<S>;
+// ---------------------------------------------------------------------------
+// Request
+// ---------------------------------------------------------------------------
+/** 请求传输层：RequestBase.submit() 会调用它，返回统一包装结构（如 Result.from 的 raw）。 */
+export type RequestSubmit = (request: RequestCommand) => unknown;
+/** 注册请求传输层；传 null 清除注册。 */
+export function configureRequest(options?: { submit?: RequestSubmit | null }): RequestSubmit | null;
+/** 请求实例：描述请求与映射，方法由 RequestBase 或子类提供。 */
+export interface RequestCommand {
+  address(): string;
+  method(): string;
+  headers(): Record<string, string>;
+  cookies(): string | null;
+  body(): unknown;
+  params(): Record<string, unknown>;
+  submit(): unknown;
+  toItem?: (row: unknown) => unknown;
+  toDetail?: (data: unknown) => unknown;
+  [key: string]: unknown;
+}
+/** 请求基类：定义请求描述与提交的默认逻辑，子类覆写或扩展。 */
+export class RequestBase {
+  method(): string;
+  headers(): Record<string, string>;
+  cookies(): string | null;
+  body(): unknown;
+  params(): Record<string, unknown>;
+  address(): string;
+  submit(): unknown;
+}
+// ---------------------------------------------------------------------------
+// Result
+// ---------------------------------------------------------------------------
+export type ResultKind = 'detail' | 'list' | 'page';
+/** 统一返回结构：自动判断 detail / list / page 并完成映射，失败时 from 抛错。 */
+export class Result<T = unknown> {
+  ok: boolean;
+  code: string;
+  msg: string | null;
+  showType: number;
+  data: T;
+  kind: ResultKind;
+  pageNum: number | null;
+  pageSize: number | null;
+  total: number | null;
+  readonly isSuccess: boolean;
+  readonly pages: number;
+  constructor(init?: Partial<Result<T>>);
+  static from<T = unknown>(
+    raw: unknown,
+    command?: { toItem?: (item: unknown) => unknown; toDetail?: (data: unknown) => unknown }
+  ): Result<T>;
+}
 // ---------------------------------------------------------------------------
 // Theme
 // ---------------------------------------------------------------------------
@@ -474,6 +537,30 @@ export function resolveYoyaMode(): 'light' | 'dark';
 export function setYoyaTheme(name?: string, options?: ThemePersistOptions): string;
 export function getYoyaTheme(): string;
+/** Binds a document-level event listener (outside click, drag, Escape, scroll). */
+export function bindDocumentEvent(
+  type: string,
+  handler: (event: Event) => void,
+  options?: AddEventListenerOptions | boolean
+): () => void;
+/** Removes a document-level event listener. */
+export function unbindDocumentEvent(
+  type: string,
+  handler: (event: Event) => void,
+  options?: AddEventListenerOptions | boolean
+): void;
+/** Binds a window-level global listener (scroll / resize / popstate). */
+export function bindWindowEvent(
+  type: string,
+  handler: (event: Event) => void,
+  options?: AddEventListenerOptions | boolean
+): () => void;
+/** Injects a <style> into <head>; dataAttribute is used for dedup and identification. */
+export function injectDocumentStyle(styleText: string, dataAttribute?: string | null): HTMLStyleElement | null;
 /** Initializes theme mode/name from explicit values or persisted storage. */
 export function initYoyaTheme(options?: InitYoyaThemeOptions): {
   mode: YoyaMode;

package/types/data-display.d.ts CHANGED Viewed

@@ -271,6 +271,83 @@ export class VScroll extends HtmlElementNode {
   check(): VScroll;
 }
+// ---------------------------------------------------------------------------
+// Tree Ranger
+// ---------------------------------------------------------------------------
+export interface TreeRangerColumnContext {
+  column: number;
+  offset: number;
+  page: number;
+  pageSize: number;
+  selection: unknown[];
+  selections: unknown[];
+}
+export interface TreeRangerLoadResult {
+  hasMore?: boolean;
+  items: unknown[];
+  pageSize?: number;
+}
+export interface TreeRangerColumn {
+  icon?: (item: unknown, index: number) => ChildInput;
+  itemText?: (item: unknown) => string;
+  pageSize?: number;
+  title?: ChildInput;
+  load?: (
+    context: TreeRangerColumnContext
+  ) => Promise<TreeRangerLoadResult | unknown[]> | TreeRangerLoadResult | unknown[];
+  renderItem?: (item: unknown, index: number) => ChildInput;
+  itemKey?: (item: unknown) => unknown;
+}
+export interface TreeRangerChangePayload {
+  current: number;
+  detail: unknown;
+  selections: unknown[];
+  type: string;
+}
+export interface TreeRangerOptions {
+  ariaLabel?: string;
+  columns?: TreeRangerColumn[];
+  columnWidth?: number;
+  emptyText?: string;
+  itemHeight?: number;
+  loadingText?: string;
+  minSize?: number;
+  overscan?: number;
+  visibleColumns?: number;
+  change?: (payload: TreeRangerChangePayload) => void;
+  onChange?: (payload: TreeRangerChangePayload) => void;
+}
+export interface TreeRanger {
+  ariaLabel(value?: string): TreeRanger;
+  columns(): TreeRangerColumn[];
+  columns(value: TreeRangerColumn[]): TreeRanger;
+  itemHeight(value?: number): number | TreeRanger;
+  overscan(value?: number): number | TreeRanger;
+  columnWidth(value?: number): number | TreeRanger;
+  minSize(value?: number): number | TreeRanger;
+  visibleColumns(value?: number): number | TreeRanger;
+  selectedKeys(): unknown[];
+  selectedItems(): unknown[];
+  current(): number;
+  back(): TreeRanger;
+  reload(): TreeRanger;
+  refresh(): TreeRanger;
+  render(): HtmlElementNode;
+  change(handler: (payload: TreeRangerChangePayload) => void): TreeRanger;
+  onChange(handler: (payload: TreeRangerChangePayload) => void): TreeRanger;
+  [key: string]: any;
+}
+export function vTreeRanger(setup?: TreeRangerColumn[] | TreeRangerOptions | SetupCallback<TreeRanger>): TreeRanger;
+export const treeRanger: typeof vTreeRanger;
+export function vTreeRangerColumn(setup?: unknown): unknown;
 // ---------------------------------------------------------------------------
 // Table
 // ---------------------------------------------------------------------------

package/types/form.d.ts CHANGED Viewed

@@ -66,6 +66,27 @@ export class VColorPicker extends HtmlElementNode {
   ): VColorPicker;
 }
+/** SVG icon picker with a dialog: opens an icon grid for selection. */
+export class VSvgIconPicker extends HtmlElementNode {
+  value(): string | null;
+  value(next: string | null): VSvgIconPicker;
+  clearValue(): VSvgIconPicker;
+  disabled(): boolean;
+  disabled(next: boolean): VSvgIconPicker;
+  name(): string;
+  name(next: string): VSvgIconPicker;
+  required(): boolean;
+  required(next: boolean): VSvgIconPicker;
+  icons(): string[];
+  icons(next: Array<string | { icon: () => any; name: string }>): VSvgIconPicker;
+  open(value?: boolean): VSvgIconPicker;
+  close(): VSvgIconPicker;
+  toggle(): VSvgIconPicker;
+  change(): Array<(name: string | null, picker: VSvgIconPicker) => void>;
+  change(handler: (name: string | null, picker: VSvgIconPicker) => void): VSvgIconPicker;
+  onChange(handler: (name: string | null, picker: VSvgIconPicker) => void): VSvgIconPicker;
+}
 /** Slider input with min/max/step constraints. */
 export class VSlider extends HtmlElementNode {
   value(): number;

package/types/svg.d.ts CHANGED Viewed

@@ -137,6 +137,7 @@ export function FolderOutlined(): SvgElementNode;
 export function FolderOpenOutlined(): SvgElementNode;
 export function HeartOutlined(): SvgElementNode;
 export function HomeOutlined(): SvgElementNode;
+export function ImageOutlined(): SvgElementNode;
 export function InfoOutlined(): SvgElementNode;
 export function LockOutlined(): SvgElementNode;
 export function LogoutOutlined(): SvgElementNode;