akanjs 3.0.0 → 3.0.2-rc.0

package/types/signal/endpointRateLimit.d.ts

@@ -0,0 +1,37 @@
+import type { EndpointInfo } from "./endpointInfo.d.ts";
+import type { SignalContext } from "./signalContext.d.ts";
+export interface RateLimitBudget {
+    calls: number;
+    /** 60_000 when unset. */
+    windowMs?: number;
+    /** `ip` (default) counts the caller's address; `account` counts `accountKey(account)`, else the address. */
+    by?: "ip" | "account";
+}
+export interface RateLimitSetting {
+    /** `false` lets every budget stand aside, as for a deployment rate-limited at its edge. */
+    enabled?: boolean;
+    /** The budget of every endpoint that declares none; unset leaves those unlimited. */
+    budget?: RateLimitBudget;
+    /** By endpoint key, over what the endpoint declares (a lib's included); `false` exempts it. */
+    endpoints?: {
+        [key: string]: Partial<RateLimitBudget> | false;
+    };
+    /** Who `by: "account"` counts; nothing returned counts the caller's address instead. */
+    accountKey?: (account: unknown) => string | null | undefined;
+}
+type ResolvedBudget = Required<RateLimitBudget>;
+export declare class EndpointRateLimit {
+    #private;
+    /** Merges over what an earlier call set, so libs configure in mount order and the app's `option.ts` goes last. */
+    static configure(setting: RateLimitSetting | false): void;
+    /**
+     * `off` wins over the code, `on` turns budgets on in a local environment, and `<calls>[/<seconds>]` is the default
+     * budget wherever the code names none. Unset, budgets apply everywhere but `local`.
+     */
+    static applyEnv(value: string | undefined, environment: string): void;
+    static reset(): void;
+    static budgetOf(key: string, endpointInfo: EndpointInfo): ResolvedBudget | null;
+    /** `ip` runs before the request body is read; `account` after the middlewares resolved the caller. */
+    static admit(context: SignalContext, phase: "ip" | "account"): Promise<void>;
+}
+export {};

package/types/signal/index.d.ts

@@ -7,6 +7,7 @@ export * from "./base.signal";
 export { CrossSiteGuard, type CrossSiteOption } from "./CrossSiteGuard.d.ts";
 export * from "./endpoint.d.ts";
 export * from "./endpointInfo.d.ts";
+export * from "./endpointRateLimit.d.ts";
 export * from "./exception.d.ts";
 export * from "./guard.d.ts";
 export * from "./guards.d.ts";

package/types/signal/signalContext.d.ts

@@ -2,7 +2,7 @@ import { type BackendEnv, type PromiseOrObject } from "akanjs/base";
 import { type ConstantFieldTypeInput } from "akanjs/constant";
 import type { Adaptor, AdaptorCls, DatabaseService, InjectRegistry, LiveRegistry } from "akanjs/service";
 import type { Internal, InternalInfo, MiddlewareCls } from ".";
-import type { EndpointInfo } from "./endpointInfo.d.ts";
+import type { ArgInfo, EndpointInfo } from "./endpointInfo.d.ts";
 import { SignalTrace, type TraceOrigin } from "./trace.d.ts";
 export type SignalTransportType = "http" | "websocket";
 /** What `Bun.Server.requestIP` reports for the socket a request arrived on. */
@@ -18,6 +18,20 @@ interface WebSocketRequest {
 type RuntimeRecord = Record<string, unknown>;
 /** Request-scoped: the outermost `resolveReturn` starts one and every recursion threads it down. */
 type ResolveCache = Map<ConstantFieldTypeInput, Map<string, Promise<unknown>>>;
+interface SignalContextOption<Ctx, Env extends BackendEnv> {
+    endpointInfo: EndpointInfo;
+    adaptor: Adaptor;
+    registry: InjectRegistry;
+    env: Env;
+    live: LiveRegistry;
+    middleware: Map<string, MiddlewareCls>;
+    /** A caller-built context: MCP's arguments arrive as one named object, not in a URL. */
+    ctx?: Ctx;
+    /** Defaults to the transport. */
+    origin?: TraceOrigin;
+    /** Unset, the context joins the current trace or opens one that `exec()` closes. */
+    trace?: SignalTrace | null;
+}
 export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketExecutionContext = HttpExecutionContext | WebSocketExecutionContext, Env extends BackendEnv = BackendEnv> {
     #private;
     key: string;
@@ -27,25 +41,20 @@ export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketE
     adaptor: Adaptor;
     /** `mcp` for a call through the MCP endpoint. Held here, not on the trace: a null trace would let a guard fail open. */
     readonly origin: TraceOrigin;
-    args: unknown[];
     internalArgs: unknown[];
     trace: SignalTrace | null;
-    constructor(key: string, reqOrWsReq: Bun.BunRequest | WebSocketRequest, { endpointInfo, adaptor, registry, env, live, middleware, ctx, origin, }: {
-        endpointInfo: EndpointInfo;
-        adaptor: Adaptor;
-        registry: InjectRegistry;
-        env: Env;
-        live: LiveRegistry;
-        middleware: Map<string, MiddlewareCls>;
-        /** A caller-built context: MCP's arguments arrive as one named object, not in a URL. */
-        ctx?: Ctx;
-        /** Defaults to the transport. */
-        origin?: TraceOrigin;
-    });
+    constructor(key: string, reqOrWsReq: Bun.BunRequest | WebSocketRequest, option: SignalContextOption<Ctx, Env>);
     getAdaptor<T extends Adaptor>(adaptorCls: AdaptorCls<T>): T;
     getService<T>(refName: string): T;
+    /** Reads the request but parses no argument: that waits for the account guards in `exec()`. */
     init(): Promise<this>;
-    /** Re-checks the guards of a subscribed room outside a request; only global middlewares (account resolution) run. */
+    /** Parsed on first read, so a guard or middleware that reads one still gets it; a parser runs at most once per call. */
+    get args(): unknown[];
+    set args(args: unknown[]);
+    /**
+     * Re-checks the guards of a subscribed room outside a request; only global middlewares (account resolution) run. On
+     * a fresh context, so a guard that memoizes per context cannot replay the verdict it gave at subscribe.
+     */
     authorize(): Promise<boolean>;
     /**
      * Evaluates only `scope = "account"` guards, to hide listing entries. Never an access gate: a resource guard fails
@@ -84,6 +93,10 @@ export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketE
      * `::ffff:`; `null`, never a placeholder, when neither is known.
      */
     getClientIp(): string | null;
+    /** A request a proxy rebuilt has no socket behind it for `requestIP`, so it keeps the address its original resolved. */
+    static carryClientIp(target: Request, source: Request): void;
+    /** `getClientIp` for a request no context wraps, as the MCP router and the page renderer hold one. */
+    static clientIpOf(req: Request): string | null;
     /** The caller's source port as the nearest proxy recorded it, else this socket's own. */
     getClientPort(): number | null;
     getRoomId(key: string): string;
@@ -113,6 +126,9 @@ export declare class HttpExecutionContext<Appended = unknown> {
     constructor(req: Bun.BunRequest);
     get url(): URL;
     getArgs(endpointInfo: EndpointInfo): Promise<unknown[]>;
+    /** Each argument as the request carries it; `parseArg` turns one into its declared type. */
+    readArgs(endpointInfo: EndpointInfo): Promise<unknown[]>;
+    parseArg(arg: ArgInfo, raw: unknown): unknown;
     makeResponse(result: unknown, endpointInfo: EndpointInfo): Response;
 }
 export type WebSocketEventType = "open" | "subscribe" | "unsubscribe" | "message" | "close";
@@ -125,6 +141,8 @@ export declare class WebSocketExecutionContext<Appended = unknown> {
     onUnsubscribe: Set<() => PromiseOrObject<void>>;
     constructor(wsReq: WebSocketRequest);
     getArgs(endpointInfo: EndpointInfo): Promise<unknown[]>;
+    readArgs(endpointInfo: EndpointInfo): Promise<unknown[]>;
+    parseArg(arg: ArgInfo, raw: unknown): unknown;
     makeResponse(result: unknown, endpointInfo: EndpointInfo): Response;
     on: (event: "disconnect" | "unsubscribe", handler: () => PromiseOrObject<void>) => void;
     off: (event: "disconnect" | "unsubscribe", handler: () => PromiseOrObject<void>) => void;

package/types/signal/slice.d.ts

@@ -30,6 +30,7 @@ export type SliceCls<SrvModule extends ServiceModel = ServiceModel, SliceInfoObj
     updateGuards: GuardCls[];
     removeGuards: GuardCls[];
     mcp: ResolvedSliceMcp;
+    crud: ResolvedSliceCrud;
 };
 /** `root` is absent: it rides on the root slice itself. */
 export interface ResolvedSliceMcp {
@@ -38,14 +39,25 @@ export interface ResolvedSliceMcp {
     update: boolean;
     remove: boolean;
 }
+/** Which generated verbs the server mounts: a verb whose guards resolve to none (or `false`) has no route at all. */
+export interface ResolvedSliceCrud {
+    get: boolean;
+    create: boolean;
+    update: boolean;
+    remove: boolean;
+}
 interface RootSliceOption {
+    /**
+     * `false` (or no guard at all) mounts no generated endpoint for that verb, which is the only way to take one off
+     * HTTP: `mcp: { cru: false }` merely keeps it off the agent shelf. `create`/`update`/`remove` fall back to `cru`.
+     */
     guards?: {
         root?: GuardCls | GuardCls[];
-        get?: GuardCls | GuardCls[];
-        cru?: GuardCls | GuardCls[];
-        create?: GuardCls | GuardCls[];
-        update?: GuardCls | GuardCls[];
-        remove?: GuardCls | GuardCls[];
+        get?: GuardCls | GuardCls[] | false;
+        cru?: GuardCls | GuardCls[] | false;
+        create?: GuardCls | GuardCls[] | false;
+        update?: GuardCls | GuardCls[] | false;
+        remove?: GuardCls | GuardCls[] | false;
     };
     /**
      * Keyed like `guards`, for the root slice and generated CRUD only; `create`/`update`/`remove` fall back to `cru`

package/types/signal/types.d.ts

@@ -1,5 +1,6 @@
 import type { DefaultPrimitiveName, UnCls } from "akanjs/base";
 import type { ServiceModel } from "akanjs/service";
+import type { RateLimitBudget } from "./endpointRateLimit.d.ts";
 import type { GuardCls } from "./guard.d.ts";
 import type { MiddlewareCls } from "./middleware.d.ts";
 import type { SliceCls } from "./slice.d.ts";
@@ -82,6 +83,11 @@ export interface SignalOption<Response = any, Nullable extends boolean = false,
      * internal argument may carry one (those answer per caller), and the lookup runs after the guards.
      */
     cache?: number;
+    /**
+     * Calls per caller per window, refused with 429 `base.error.tooManyRequests`. `by: "ip"` is counted before the body
+     * is read, `by: "account"` after the middlewares and before the guards; `false` exempts it from the app's default.
+     */
+    rateLimit?: RateLimitBudget | false;
     guards?: GuardCls[];
     middlewares?: MiddlewareCls[];
     prefix?: false | string;
@@ -178,6 +184,8 @@ export interface SerializedSignal {
     removeGuards?: string[];
     /** Generated CRUD verbs kept off the agent shelf, carried here because `FetchClient.getBaseEndpoint` synthesizes them. */
     mcp?: SerializedSignalMcp;
+    /** Generated CRUD verbs the server does not mount at all, so no client synthesizes them. */
+    crud?: SerializedSignalMcp;
     /** Which generated CRUD verbs a person-only guard protects, by the same verb map; only the `false` keys travel. */
     agents?: SerializedSignalMcp;
 }

package/types/test/signalTestRuntime.d.ts

@@ -1,4 +1,4 @@
-import type { FetchProxy } from "akanjs/fetch";
+import { type FetchProxy } from "akanjs/fetch";
 import type { AkanLib } from "akanjs/server";
 import { type TestEnv, type TestServerOptions } from "./testServer.d.ts";
 export interface SignalTestTarget {

package/types/ui/recipe/badgeRecipe.d.ts

@@ -1,15 +1,15 @@
 /** 뱃지 look — 시맨틱 variant × size, outline 플래그는 색을 유지한 외곽선 스타일. `<Badge>` 가 소비하며, recipes.badge 슬롯으로 교체 가능. */
 export declare const badgeRecipe: (variants?: Omit<({
     size?: "lg" | "md" | "sm" | "xs" | undefined;
-    outline?: boolean | undefined;
     variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
+    outline?: boolean | undefined;
 } & {
     class?: import("tailwind-variants").ClassValue;
     className?: never;
 }) | ({
     size?: "lg" | "md" | "sm" | "xs" | undefined;
-    outline?: boolean | undefined;
     variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
+    outline?: boolean | undefined;
 } & {
     class?: never;
     className?: import("tailwind-variants").ClassValue;

package/types/ui/recipe/buttonRecipe.d.ts

@@ -1,16 +1,16 @@
 /** 버튼 look — 시맨틱 variant × size × shape, outline 플래그는 색을 유지한 외곽선 스타일. `<Button>` 이 소비하며, `_overrides.tsx` 의 recipes.button 슬롯으로 교체 가능. */
 export declare const buttonRecipe: (variants?: Omit<({
-    size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
-    outline?: boolean | undefined;
+    size?: "xl" | "lg" | "md" | "sm" | "xs" | "icon" | undefined;
     variant?: "default" | "link" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
+    outline?: boolean | undefined;
     shape?: "default" | "circle" | "square" | undefined;
 } & {
     class?: import("tailwind-variants").ClassValue;
     className?: never;
 }) | ({
-    size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
-    outline?: boolean | undefined;
+    size?: "xl" | "lg" | "md" | "sm" | "xs" | "icon" | undefined;
     variant?: "default" | "link" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
+    outline?: boolean | undefined;
     shape?: "default" | "circle" | "square" | undefined;
 } & {
     class?: never;

package/types/ui/recipe/inputRecipe.d.ts

@@ -1,13 +1,13 @@
-/** 입력 표면 look — Input/TextArea/DatePicker 가 공유하는 필드 셸. kind 로 한 줄 필드(field)/멀티라인(area), tone 으로 강조/오류 상태를 고른다. */
+/** 입력 표면 look — Input/TextArea/DatePicker 가 공유하는 필드 셸. kind 로 한 줄 필드(field)/멀티라인(area)/네이티브 `<select>`(select), tone 으로 강조/오류 상태를 고른다. */
 export declare const inputRecipe: (variants?: Omit<({
-    kind?: "field" | "area" | undefined;
+    kind?: "select" | "field" | "area" | undefined;
     size?: "xl" | "lg" | "md" | "sm" | "xs" | undefined;
     tone?: "default" | "error" | "primary" | undefined;
 } & {
     class?: import("tailwind-variants").ClassValue;
     className?: never;
 }) | ({
-    kind?: "field" | "area" | undefined;
+    kind?: "select" | "field" | "area" | undefined;
     size?: "xl" | "lg" | "md" | "sm" | "xs" | undefined;
     tone?: "default" | "error" | "primary" | undefined;
 } & {

package/types/vendor/@akanjs/native/packages/cli/src/config.d.ts

@@ -300,6 +300,14 @@ export interface AkanNativeConfig {
          * macOS builds sign every Mach-O file in it.
          */
         bin?: string;
+        /**
+         * macOS: the Finder window the disk image (`--installer`, API `macos.dmg`) opens in: no toolbar, sidebar or status
+         * bar, the app's and the Applications link's icons on a background, and the app's icon on the mounted disk. Without
+         * it the window is 660×400 pt on akan-native's background, an arrow from the app at (180, 170) to Applications at
+         * (480, 170). A position is an icon's center, in points from the window's top left; the default background lines
+         * up with the default positions only.
+         */
+        dmg?: DmgConfig;
     };
     /**
      * App icon for every platform, generated from one square PNG, ideally 1024×1024 (CLI-8).
@@ -330,4 +338,29 @@ export interface AkanNativeConfig {
         timeout?: number;
     };
 }
+export interface DmgConfig {
+    /** A PNG (or TIFF) the size of the window in points, or false for a plain window. */
+    background?: string | false;
+    /** The same picture at twice the pixels, for a Retina display: the disk image carries both in one TIFF. */
+    background2x?: string;
+    /** In points. Default the background's size (660×400 without one) at 200, 120 on the screen. */
+    window?: {
+        x?: number;
+        y?: number;
+        width?: number;
+        height?: number;
+    };
+    /** Default 128. */
+    iconSize?: number;
+    /** Default 13. */
+    textSize?: number;
+    app?: {
+        x: number;
+        y: number;
+    };
+    applications?: {
+        x: number;
+        y: number;
+    };
+}
 export declare function defineConfig(config: AkanNativeConfig): AkanNativeConfig;

package/types/vendor/@akanjs/native/packages/cli/src/lib/bplist.d.ts

@@ -0,0 +1,11 @@
+/** A number written as a real even when it is whole: Finder reads `iconSize` and `textSize` as reals. */
+export declare class Real {
+    readonly value: number;
+    constructor(value: number);
+}
+export type BplistValue = string | number | boolean | Uint8Array | Real | {
+    [key: string]: BplistValue;
+};
+export declare function writeBplist(root: {
+    [key: string]: BplistValue;
+}): Uint8Array;

package/types/vendor/@akanjs/native/packages/cli/src/lib/dmg.d.ts

@@ -0,0 +1,59 @@
+import type { DmgConfig } from "../config.ts";
+import { type DsStoreRecord } from "./dsStore.ts";
+interface Point {
+    x: number;
+    y: number;
+}
+export interface ResolvedDmg {
+    /** Absolute; null for a plain window. */
+    background: {
+        image: string;
+        image2x?: string;
+    } | null;
+    /** The window's size defaults to the background's. */
+    window: {
+        x: number;
+        y: number;
+        width?: number;
+        height?: number;
+    };
+    iconSize: number;
+    textSize: number;
+    app: Point;
+    applications: Point;
+}
+export declare const DMG_DEFAULTS: {
+    readonly window: {
+        readonly x: 200;
+        readonly y: 120;
+    };
+    readonly iconSize: 128;
+    readonly textSize: 13;
+    readonly app: {
+        readonly x: 180;
+        readonly y: 170;
+    };
+    readonly applications: {
+        readonly x: 480;
+        readonly y: 170;
+    };
+};
+export declare function validateDmg(dmg: DmgConfig | undefined, appDir: string, problems: string[]): ResolvedDmg;
+export declare function dmgRecords(layout: ResolvedDmg, { appName, size, backgroundAlias, }: {
+    appName: string;
+    size: {
+        width: number;
+        height: number;
+    };
+    backgroundAlias?: Uint8Array;
+}): DsStoreRecord[];
+export declare function buildDmg(appPath: string, dmgPath: string, volumeName: string, workDir: string, { layout, volumeIcon }: {
+    layout: ResolvedDmg;
+    volumeIcon?: string;
+}): Promise<void>;
+/**
+ * The createDate of the HFS+ volume a read-write image holds: its header ("H+", version 4) sits 1024 bytes into the
+ * partition, which `hdiutil create` puts within the image's first mebibyte, its data stored as is.
+ */
+export declare function volumeHeaderCreateDate(image: string): number;
+export {};

package/types/vendor/@akanjs/native/packages/cli/src/lib/dsStore.d.ts

@@ -0,0 +1,26 @@
+export type DsStoreValue = {
+    type: "long";
+    value: number;
+} | {
+    type: "bool";
+    value: boolean;
+} | {
+    type: "type";
+    value: string;
+} | {
+    type: "blob";
+    value: Uint8Array;
+} | {
+    type: "ustr";
+    value: string;
+};
+export interface DsStoreRecord {
+    /** The file the record is about, "." for the folder itself. */
+    name: string;
+    /** Four letters: Iloc (icon location), bwsp (window), icvp (icon view), vSrn, icvl … */
+    code: string;
+    value: DsStoreValue;
+}
+export declare function writeDsStore(records: DsStoreRecord[]): Uint8Array;
+/** Reads back what writeDsStore wrote (one leaf): the tests' check, and a way to look at a .DS_Store. */
+export declare function readDsStore(file: Uint8Array): DsStoreRecord[];

package/types/vendor/@akanjs/native/packages/cli/src/lib/macAlias.d.ts

@@ -0,0 +1,24 @@
+export interface AliasTarget {
+    /** The HFS+ volume name (the disk image's label). */
+    volumeName: string;
+    /**
+     * The volume header's createDate as it stands, in HFS seconds. HFS+ writes it on the local clock of whatever formatted
+     * the volume (TN1150), unlike every other date, so it is read off the image rather than computed here.
+     */
+    volumeCreated: number;
+    /** Where the volume mounts: /Volumes/<name>. */
+    volumePath: string;
+    kind: "file" | "folder";
+    name: string;
+    cnid: number;
+    created: Date;
+    parentName: string;
+    parentCnid: number;
+    /** The CNIDs of the folders above the target, nearest first, the volume's root left out. */
+    cnidPath: number[];
+    /** From the volume's root, starting with "/". */
+    posixPath: string;
+}
+/** Seconds since 1904-01-01 UTC, the HFS epoch. */
+export declare function hfsTime(date: Date): number;
+export declare function aliasRecord(target: AliasTarget): Uint8Array;

package/types/vendor/@akanjs/native/packages/cli/src/lib/macossigning.d.ts

@@ -83,7 +83,6 @@ export declare function staple(file: string): Promise<void>;
 /** The .app as notarytool takes it: a zip that keeps the bundle's symlinks and signature. */
 export declare function zipForNotary(appPath: string, zip: string): Promise<void>;
 /** A compressed disk image of the app beside a link to /Applications, the window people drag it into. */
-export declare function buildDmg(appPath: string, dmgPath: string, volumeName: string, workDir: string): Promise<void>;
 /** What Gatekeeper says of a notarized app or disk image, as a downloaded copy would be judged. */
 export declare function assessGatekeeper(file: string, type: "execute" | "open"): Promise<void>;
 /**

package/types/vendor/@akanjs/native/packages/cli/src/lib/project.d.ts

@@ -1,12 +1,13 @@
 import type { AkanNativeConfig } from "../config.ts";
 import { type PermissionSet } from "./acl.ts";
 import { type DesktopServerConfig } from "./desktop-server.ts";
+import { type ResolvedDmg } from "./dmg.ts";
 import { type EnvConfig } from "./env.ts";
 import { CliError } from "./log.ts";
 import { type PermissionsConfig } from "./permissions.ts";
 import type { PlistValue } from "./plist.ts";
 import { type UpdatesConfig } from "./updates.ts";
-export interface ResolvedConfig extends Omit<AkanNativeConfig, "icon" | "splash" | "permissions" | "updates"> {
+export interface ResolvedConfig extends Omit<AkanNativeConfig, "icon" | "splash" | "permissions" | "updates" | "desktop"> {
     app: Required<AkanNativeConfig["app"]>;
     web: Required<Pick<AkanNativeConfig["web"], "dir" | "base">> & {
         build?: string;
@@ -38,6 +39,7 @@ export interface ResolvedConfig extends Omit<AkanNativeConfig, "icon" | "splash"
         server?: DesktopServerConfig;
         /** Absolute. */
         bin?: string;
+        dmg: ResolvedDmg;
     };
     updates: UpdatesConfig | null;
     /** Absolute image path. */

package/types/vendor/@akanjs/native/packages/cli/src/platforms/linux-appimage.d.ts

@@ -1,6 +1,11 @@
 import type { BuildContext } from "../lib/prepare.ts";
-/** The launcher entry (freedesktop Desktop Entry): what a menu shows and which link schemes open the app. */
+/**
+ * The launcher entry (freedesktop Desktop Entry): what a menu shows and which link schemes open the app. Named and
+ * matched by the app id, the window's program name (native/desktop lib.rs): AppImageLauncher and appimaged rename the
+ * file they install, so StartupWMClass is what still ties the window to it.
+ */
 export declare function desktopEntry(input: {
+    id: string;
     name: string;
     fileName: string;
     schemes: string[];

package/types/vendor/@akanjs/native/packages/desktop/src/deeplinks.d.ts

@@ -7,10 +7,16 @@ type Runner = (argv: string[]) => Promise<{
 export declare function linkArguments(args: readonly string[], schemes: readonly string[]): string[];
 /** Exec= of a desktop entry: the path quoted, with the characters the spec reserves escaped. */
 export declare function desktopExec(exe: string): string;
-export declare function desktopEntry(name: string, exe: string, schemes: readonly string[]): string;
+export declare function desktopEntry(name: string, exe: string, schemes: readonly string[], { id, icon }?: {
+    id?: string;
+    icon?: boolean;
+}): string;
 /** mimeapps.list with `x-scheme-handler/<scheme>=<desktop file>` set in [Default Applications]. */
 export declare function withDefaults(list: string, desktopFile: string, schemes: readonly string[]): string;
-/** Makes this executable the current user's handler of the app's schemes (Windows, Linux). */
+/**
+ * Makes this executable the current user's handler of the app's schemes (Windows, Linux). `icon`: a 256 px PNG the
+ * Linux entry shows (resources/icon.png).
+ */
 export declare function registerDeepLinks(app: {
     id: string;
     name: string;
@@ -20,5 +26,6 @@ export declare function registerDeepLinks(app: {
     env?: Env;
     home?: string;
     run?: Runner;
+    icon?: string;
 }): Promise<void>;
 export {};

package/types/webkit/RenderFailure.d.ts

@@ -0,0 +1,6 @@
+interface RenderFailureProps {
+    error: unknown;
+    onRetry: () => void;
+}
+export declare const RenderFailure: ({ error, onRetry }: RenderFailureProps) => import("react").JSX.Element;
+export {};

package/types/webkit/useFrameRuntime.d.ts

@@ -86,7 +86,6 @@ export declare function resolvePathRoutesWithFrameState(pathRoutes: PathRoute[],
     renderRootLayouts: import("akanjs/client").RouteRender[];
     renderLayouts: import("akanjs/client").RouteRender[];
     resolveHead?: import("akanjs/client").ResolveHead;
-    isSpecialRoute?: boolean;
 }[];
 export declare function resolveLocationWithFrameState(location: Location | null, resolvedPathRouteMap: Map<string, PathRoute>): Location | null;
 export declare function useFrameRuntimeResync({ updateViewport }: {

package/ui/Input.tsx

@@ -362,6 +362,12 @@ const DefaultEmail = ({
   );
 };
 
+const parseTypedNumber = (text: string) => {
+  const kept = text.replace(/[^\d.-]/g, "");
+  const [whole = "", ...fraction] = kept.replace(/-/g, "").split(".");
+  return parseFloat(`${kept.startsWith("-") ? "-" : ""}${whole}${fraction.length ? `.${fraction.join("")}` : ""}`);
+};
+
 export type NumberProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "type" | "onChange"> & {
   value: number | null;
   nullable?: boolean;
@@ -420,7 +426,7 @@ const DefaultNumber = ({
 
   const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
     if (e.key !== "Enter" && e.key !== "Escape") return;
-    const numberValue = parseFloat(e.currentTarget.value.replace(/[^\d-]/g, ""));
+    const numberValue = parseTypedNumber(e.currentTarget.value);
     if (Number.isNaN(numberValue)) {
       e.currentTarget.value = "";
       setFormatValue("");

package/ui/recipe/buttonRecipe.ts

@@ -26,6 +26,7 @@ export const buttonRecipe = recipe(
         sm: "h-8 px-3 text-sm",
         md: "h-10 px-4",
         lg: "h-12 px-6 text-lg",
+        xl: "h-14 px-8 text-xl",
         icon: "h-10 w-10 px-0",
       },
       

package/ui/recipe/inputRecipe.ts

@@ -1,11 +1,17 @@
 import { recipe, tv } from "./factory";
 
-/** 입력 표면 look — Input/TextArea/DatePicker 가 공유하는 필드 셸. kind 로 한 줄 필드(field)/멀티라인(area), tone 으로 강조/오류 상태를 고른다. */
+/** 입력 표면 look — Input/TextArea/DatePicker 가 공유하는 필드 셸. kind 로 한 줄 필드(field)/멀티라인(area)/네이티브 `<select>`(select), tone 으로 강조/오류 상태를 고른다. */
 export const inputRecipe = recipe(
   tv({
     base: "w-full rounded-field border border-input bg-background text-foreground focus:border-primary focus:outline-none",
     variants: {
-      kind: { field: "px-3", area: "p-3" },
+      kind: {
+        field: "px-3",
+        area: "p-3",
+        
+        select:
+          "appearance-none bg-[image:linear-gradient(to_top_right,transparent_50%,currentColor_50%,currentColor_calc(50%+2px),transparent_calc(50%+2px)),linear-gradient(to_bottom_right,transparent_calc(50%-2px),currentColor_calc(50%-2px),currentColor_50%,transparent_50%)] bg-[length:5px_6px] bg-[position:calc(100%-14px)_50%,calc(100%-9px)_50%] bg-no-repeat pr-7 pl-3",
+      },
       size: { xs: "text-xs", sm: "text-sm", md: "text-sm", lg: "text-base", xl: "text-lg" },
       tone: {
         default: "",
@@ -15,11 +21,11 @@ export const inputRecipe = recipe(
     },
     
     compoundVariants: [
-      { kind: "field", size: "xs", class: "h-6" },
-      { kind: "field", size: "sm", class: "h-8" },
-      { kind: "field", size: "md", class: "h-10" },
-      { kind: "field", size: "lg", class: "h-12" },
-      { kind: "field", size: "xl", class: "h-14" },
+      { kind: ["field", "select"], size: "xs", class: "h-6" },
+      { kind: ["field", "select"], size: "sm", class: "h-8" },
+      { kind: ["field", "select"], size: "md", class: "h-10" },
+      { kind: ["field", "select"], size: "lg", class: "h-12" },
+      { kind: ["field", "select"], size: "xl", class: "h-14" },
     ],
     defaultVariants: { kind: "field", size: "md", tone: "default" },
   }),

package/ui/styles.css

@@ -1,4 +1,5 @@
 @source "./**/*";
+@source "../webkit/RenderFailure.tsx";
 @plugin "tailwind-scrollbar";
 
 /* data-theme=dark 를 Tailwind dark: 변형에 연결. 프레임워크(system)가 소유하므로

package/vendor/@akanjs/native/native/desktop/src/lib.rs

@@ -759,7 +759,7 @@ struct Config {
   data_dir: Option<PathBuf>,
   /// Window icon (Windows, Linux): [u32 width LE][u32 height LE][RGBA], written by the CLI.
   icon: Option<PathBuf>,
-  /// app.id (Linux: the desktop entry the dock plugin's launcher badge names).
+  /// app.id (Linux: the window's program name, so the dock matches it to <app id>.desktop).
   app_id: String,
   /// security.shell.externalSchemes (L0): schemes links may also hand to the OS (navigation.rs).
   external_schemes: Vec<String>,
@@ -1805,6 +1805,13 @@ pub unsafe extern "C" fn akan_native_run(config_json: *const c_char) -> i32 {
     log!("pages from {base} (akan-native dev --hmr)");
   }
   navigation::set_extra_schemes(cfg.external_schemes.clone());
+  // Linux: GTK names the window after the program (X11 WM_CLASS, Wayland app_id), and a dock shows the <name>.desktop
+  // that matches it, so the name is the app id the deep links and the dock plugin write their entry under. Not tao's
+  // with_app_id: a second launch would then hand itself to the first over D-Bus and exit before single-instance runs.
+  #[cfg(target_os = "linux")]
+  if !cfg.app_id.is_empty() {
+    gtk::glib::set_prgname(Some(cfg.app_id.as_str()));
+  }
   #[cfg(not(target_os = "windows"))]
   #[cfg_attr(not(target_os = "macos"), allow(unused_mut))]
   let mut event_loop = EventLoopBuilder::<UserEvent>::with_user_event().build();