@_tc/template-core 0.2.12 → 0.3.0

package/types/bundler/entryCollect.d.ts

@@ -0,0 +1,36 @@
+export type EntryMap = Record<string, string>;
+export type SSREntriesMode = 'merge' | 'replace';
+export type SSREntriesConfig = EntryMap;
+export interface SSREntriesOptions {
+    baseDir?: string;
+    ssrEntries?: SSREntriesConfig;
+    ssrEntriesMode?: SSREntriesMode;
+}
+/**
+ * 判断入口文件是否位于根级 ssr/apps 目录。
+ */
+export declare const isSSRAppsPath: (filePath: string) => boolean;
+/**
+ * 从 *.entry.* 文件名中提取入口名。
+ */
+export declare const toEntryName: (filePath: string) => string;
+/**
+ * 收集非 SSR 的 CSR 入口文件。
+ */
+export declare function collectCSREntryFiles(scanPaths: string[]): string[];
+/**
+ * 收集 SSR 入口文件。
+ */
+export declare function collectSSREntryFiles(scanPaths: string[]): string[];
+/**
+ * 将入口文件列表转换成 Vite input map。
+ */
+export declare function createEntryMap(files: string[]): EntryMap;
+/**
+ * 标准化用户传入的 ssrEntries 配置。
+ */
+export declare function normalizeConfiguredSSREntries(options?: SSREntriesOptions): EntryMap;
+/**
+ * 合并自动扫描和显式配置的 SSR entries。
+ */
+export declare function collectSSREntries(scanPaths: string[], options?: SSREntriesOptions): EntryMap;

package/types/bundler/feSharedConfig.d.ts

@@ -0,0 +1,35 @@
+import type { PluginOption } from "vite";
+import { type ResolveFEOutDirOptions } from "../ssrSharedData/outputPaths";
+export interface BundlerPaths {
+    currentDir: string;
+    frameNodePath: string;
+    framePackagePath: string;
+    frameFEPath: string;
+    frameSSRPath: string;
+    frameSSRAppsPath: string;
+    frameReactUIPath: string;
+    frameReactHooksPath: string;
+    frameCommonPath: string;
+    hasFramePublishedSSREntries: boolean;
+}
+/**
+ * 从当前框架包位置推导源码态/发布态路径。
+ */
+export declare function createBundlerPaths(): BundlerPaths;
+/**
+ * 从当前包位置解析依赖包目录，保证框架和业务使用同一份依赖。
+ */
+export declare function resolvePackageDir(packageName: string): string;
+export declare function createReactResolveAlias(): Record<string, string>;
+export declare function resolveAliasWithFallback(aliasList: [aliasName: string, aliasPath: string, basePath: string, fallbackPath?: string][], paths: Pick<BundlerPaths, 'currentDir'>): Record<string, string>;
+export declare function createScalabilityAliases(runFEPath: string, paths: Pick<BundlerPaths, 'currentDir' | 'frameFEPath'>): Record<string, string>;
+export declare function createFECompatibleResolveAlias(options: {
+    runFEPath: string;
+    paths: BundlerPaths;
+    includeSourceOnlyAliases?: boolean;
+}): Record<string, string>;
+export declare function createCSRResolveAlias(paths: BundlerPaths, options?: ResolveFEOutDirOptions): Record<string, string>;
+export declare function createSSRResolveAlias(paths: BundlerPaths, options?: ResolveFEOutDirOptions): Record<string, string>;
+export declare const ssrReactExternal: string[];
+export declare function createSSRNoExternal(paths: Pick<BundlerPaths, 'framePackagePath'>, extraNoExternal?: string[]): string[];
+export declare function createFEBasePlugins(): PluginOption[];

package/types/bundler/index.d.ts

@@ -1,3 +1,7 @@
 export { buildBE } from "./buildBE";
 export type { BuildBEAlias, BuildBEFormat, BuildBEOptions, BuildBEResult } from "./buildBE";
 export { buildFE } from "./buildFE";
+export { buildSSR, ssrClientOutDir, ssrEntries, ssrManifestOutDir, ssrServerOutDir, watchSSRFiles } from "./buildSSR";
+export type { BuildSSROptions, WatchSSRFilesOptions } from "./buildSSR";
+export { resolveFEOutDir } from "./utils";
+export type { FEOutDirOutput, ResolveFEOutDirOptions } from "./utils";

package/types/bundler/ssrClientManifest.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 将 Vite client manifest 从 public dist 移入私有 SSR 目录。
+ */
+export declare function moveClientManifestToSSRPrivate(clientOutDir: string, privateManifestDir: string): void;

package/types/bundler/ssrEntries.d.ts

@@ -0,0 +1,23 @@
+import { type ResolveFEOutDirOptions } from "../ssrSharedData/outputPaths";
+import { type SSREntriesConfig, type SSREntriesMode } from "./entryCollect";
+import type { BundlerPaths } from "./feSharedConfig";
+export interface BundlerSSREntriesOptions extends ResolveFEOutDirOptions {
+    /**
+     * Additional or replacement SSR entry map.
+     */
+    ssrEntries?: SSREntriesConfig;
+    /**
+     * - merge: auto-discovered entries + configured entries, configured wins.
+     * - replace: only configured entries are used.
+     */
+    ssrEntriesMode?: SSREntriesMode;
+}
+export interface CollectBundlerSSREntriesLogOptions {
+    enabled?: boolean;
+    emptyMessage?: string;
+}
+/**
+ * 扫描业务和框架 ssr/apps/ 下的 .entry.* 文件。
+ * 默认同时合并框架和业务入口；重名时业务优先。
+ */
+export declare function collectBundlerSSREntries(bundlerPaths: Pick<BundlerPaths, 'frameSSRAppsPath'>, options?: BundlerSSREntriesOptions, logOptions?: CollectBundlerSSREntriesLogOptions): Record<string, string>;

package/types/bundler/state.d.ts

@@ -1,4 +1,5 @@
-export interface BuildFEOptions {
+import type { ResolveFEOutDirOptions } from "../ssrSharedData/outputPaths";
+export interface BuildFEOptions extends ResolveFEOutDirOptions {
     /**
      * - frame
      *   - The build output will be placed under node_modules/.../app/public.
@@ -10,7 +11,6 @@ export interface BuildFEOptions {
      * - Function
      *   - Maybe you really do not need it.
      */
-    output?: 'frame' | 'run' | (() => string);
     /**
      * Compress the html content emitted by Vite before writing final `.tpl` / `.html` files.
      */

package/types/bundler/utils.d.ts

@@ -1,14 +1,47 @@
 import { Plugin } from "vite";
+import { resolveRunPath, type ResolveFEOutDirOptions } from "../ssrSharedData/outputPaths";
+export type { FEOutDirOutput, ResolveFEOutDirOptions } from "../ssrSharedData/outputPaths";
+export { resolveRunPath };
+/**
+ * 兼容旧 bundler 入口的 FE dist 目录解析函数。
+ */
+export declare function resolveFEOutDir(options?: ResolveFEOutDirOptions): string;
 /**
  *
  * 寻找 frontend\/**\/*.entry.[j|t]s(x)?
  * 生成入口
  */
-export declare function entries(): Record<string, string>;
+export declare function entries(options?: ResolveFEOutDirOptions): Record<string, string>;
 export declare function outDir(): string;
 export declare const watchFiles: (callback?: () => Promise<any>) => Promise<void>;
 /**
  * 打包完成后触发
  */
 export declare function generateBuildKeyPlugin(): Plugin;
-export declare const VBuildFE: (input: Record<string, string>, OperatingEnv?: "dev" | "prod") => Promise<void>;
+/**
+ * 创建 CSR/SSR 复用的 FE chunk 分组规则。
+ */
+export declare const createFECodeSplittingGroups: () => ({
+    name: string;
+    test: (moduleId: string) => boolean;
+    maxSize: number;
+    priority: number;
+    minShareCount?: undefined;
+} | {
+    name: string;
+    test: (moduleId: string) => boolean;
+    maxSize: number;
+    minShareCount: number;
+    priority: number;
+})[];
+export interface VBuildFEOptions {
+    /**
+     * SSR hydration entries to include in the same browser build.
+     */
+    ssrInput?: Record<string, string>;
+    /**
+     * Private output directory for the client manifest used by SSR rendering.
+     */
+    ssrManifestOutDir?: string;
+}
+export declare const VBuildFE: (input: Record<string, string>, OperatingEnv?: "dev" | "prod", options?: VBuildFEOptions) => Promise<void>;

package/types/config/config.default.d.ts

@@ -45,6 +45,16 @@ export interface DefaultAppConfig {
      * @default 5 * 60 * 1000
      */
     resourceCacheTimeMs?: number;
+    /**
+     * SSR 运行时配置。
+     */
+    ssr?: {
+        /**
+         * 是否在 SSR 错误页输出详细异常信息。
+         * 默认 local 环境输出，非 local 环境隐藏。
+         */
+        exposeErrorDetails?: boolean;
+    };
     /**
      * 登陆验证相关
      */

package/types/packages/common/i18n/types.d.ts

@@ -76,6 +76,8 @@ export type I18nTranslator = <T = string>(key: string, fillingData?: I18nInterpo
 export interface I18nActions {
     /** 设置当前展示语言。 */
     setLanguage: (language: I18nLanguage) => void;
+    /** 从本地缓存恢复语言，通常在客户端挂载后调用。 */
+    hydrateStoredLanguage: () => void;
     /** 设置兜底语言。 */
     setFallbackLanguage: (language: I18nLanguage) => void;
     /** 批量设置多语言资源，可选择替换或合并。 */

package/types/packages/common/index.d.ts

@@ -7,5 +7,6 @@ export * from "./log";
 export * from "./number";
 export * from "./object";
 export * from "./rafTimer";
+export * from "./ssr";
 export * from "./string";
 export * from "./types";

package/types/packages/common/ssr/hydration.d.ts

@@ -0,0 +1,72 @@
+/**
+ * SSR Hydration 注水协议
+ *
+ * 服务端渲染时，将初始数据序列化为 base64 后注入到 HTML 中：
+ * <script>window.__SSR_DATA__ = "..."</script>
+ *
+ * 客户端 hydration 时，从 window.__SSR_DATA__ 解码恢复状态。
+ */
+/**
+ * 注水数据结构
+ */
+export interface SSRHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>> {
+    /** 页面组件 props */
+    props: Props;
+    /** 初始 store 状态（可选） */
+    state: State;
+    /** 页面元信息 */
+    meta: SSRPageMeta;
+}
+/**
+ * 页面元信息
+ */
+export interface SSRPageMeta {
+    /** 页面标题 */
+    title?: string;
+    /** 页面描述 */
+    description?: string;
+    /** 渲染时间戳（服务端生成） */
+    renderedAt: number;
+    /** 请求路径 */
+    pathname: string;
+}
+/**
+ * 全局注水数据的 key
+ */
+export declare const SSR_DATA_KEY = "__SSR_DATA__";
+/**
+ * 声明 window 上的注水数据类型
+ */
+declare global {
+    interface Window {
+        [SSR_DATA_KEY]?: SSRHydrationData | string;
+    }
+}
+/**
+ * 服务端：将注水数据序列化为 inline script 内容。
+ * 数据内容以 base64 字符串注入，避免在 HTML 中明文暴露 JSON。
+ */
+export declare function serializeHydrationDataScriptContent(data: SSRHydrationData): string;
+/**
+ * 服务端：将注水数据序列化为 script 标签。
+ */
+export declare function serializeHydrationData(data: SSRHydrationData): string;
+/**
+ * 客户端：从 window 查看注水数据
+ * 不会清除全局数据，适合入口工厂与组件 hook 在同一次 hydration 中共享。
+ */
+export declare function peekHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>>(): SSRHydrationData<Props, State> | null;
+/**
+ * 客户端：清除 window 上的注水数据
+ * 推荐在 hydration 首次提交后调用，避免初次渲染期间的读取竞争。
+ */
+export declare function clearHydrationData(): void;
+/**
+ * 客户端：从 window 读取注水数据
+ * 保持历史兼容：读取后立即清除。
+ */
+export declare function readHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>>(): SSRHydrationData<Props, State> | null;
+/**
+ * 服务端：创建注水数据对象
+ */
+export declare function createHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>>(props: Props, meta: Omit<SSRPageMeta, 'renderedAt'>, state?: State): SSRHydrationData<Props, State>;

package/types/packages/common/ssr/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SSR 环境检测与守卫工具
+ */
+/**
+ * 是否在浏览器环境中运行
+ */
+export declare const isBrowser: boolean;
+/**
+ * 是否在服务端环境中运行
+ */
+export declare const isServer: boolean;
+/**
+ * 仅在浏览器环境执行回调，服务端返回 fallback
+ */
+export declare function clientOnly<T>(fn: () => T, fallback: T): T;
+/**
+ * 安全访问 window 对象
+ * 服务端返回 undefined
+ */
+export declare function safeWindow(): Window | undefined;
+/**
+ * 安全访问 document 对象
+ * 服务端返回 undefined
+ */
+export declare function safeDocument(): Document | undefined;
+/**
+ * 安全读取 localStorage
+ */
+export declare function safeLocalStorage(key: string, fallback?: string): string;
+/**
+ * 安全写入 localStorage
+ */
+export declare function safeSetLocalStorage(key: string, value: string): void;
+export * from "./hydration";

package/types/packages/core/loader/merge.d.ts

@@ -0,0 +1,3 @@
+type RecordTree = Record<string, unknown>;
+export declare function warnFrameBusinessOverrides(loaderName: string, frameModules: RecordTree, businessModules: RecordTree): void;
+export {};

package/types/packages/core/loader/model.d.ts

@@ -1,6 +1,6 @@
 import { KoaApp } from "../types";
 /**
- *  xx/model/* ->
+ *  xx/models/* ->
  *  [
  *      {
  *          model:{
@@ -29,7 +29,7 @@ export interface ModelItem {
 }
 export type ModelConfig = ModelItem[];
 /**
- * 获取使用方的 跟路径下的 model文件夹
+ * 获取使用方的根路径下的 models 文件夹
  * @param app
  */
 declare const modelLoader: (app: KoaApp) => ModelConfig;

package/types/packages/core/paths.d.ts

@@ -12,3 +12,8 @@ export declare function getAppPath(app: KoaApp, type: AppPathType): string | und
  * 获取所有app目录
  */
 export declare function getAppPaths(app: KoaApp): string[];
+/**
+ * 规范化路由前缀，保留根路径为空串的语义。
+ */
+export declare function normalizeRouteBasePath(basePath?: string, fallback?: string): string;
+export declare function assertRouteBasePathNotConflict(pageBasePath?: string, ssrPageBasePath?: string): void;

package/types/packages/core/types.d.ts

@@ -128,8 +128,17 @@ export interface StartOptions {
      * - 所有前端页面的路径以 /test开头
      * - 如： '/test/dash'
      *
+    */
+    pageBasePath?: string;
+    /**
+     * - 页面访问前缀 默认为 /fessr
+     * @default '/fessr'
+     * @example
+     * - 配置 '/tssr'
+     * - 所有ssr页面的路径以 /tssr 开头
+     * - 如： '/tssr/dash'
      */
-    pageBasePage?: string;
+    ssrPageBasePath?: string;
 }
 export interface AppOptions extends StartOptions {
     overwriteOriginalLogs?: boolean;

package/types/scripts/vite-build/build.d.ts

@@ -16,6 +16,7 @@ import type { BuildEntriesConfig, BuildEntriesResult } from "./types.ts";
  * @param config.extensions - 需要处理的文件扩展名
  * @param config.nonCodeExtensions - 非代码文件扩展名
  * @param config.plugins - Vite 插件配置
+ * @param config.emptyOutDir - 是否在每个输出目录首次写入前清空目录
  * @param config.dts - 类型声明文件配置
  * @param config.outDir - 输出根目录，默认 'dist'
  * @param config.rootDir - 项目根目录，默认当前工作目录

package/types/scripts/vite-build/types.d.ts

@@ -82,6 +82,7 @@ export type BuildEntriesConfig = {
     ignore?: IgnoreConfig;
     copy?: CopyConfig;
     minify?: boolean;
+    emptyOutDir?: boolean;
     dtsOnly?: boolean;
     preserveSideEffectStyleImports?: boolean;
     extensions?: ExtensionConfig;
@@ -97,6 +98,7 @@ export type BuildEntriesConfig = {
         rewriteAlias?: Record<string, string> | Alias[];
         useInputFiles?: boolean;
         clean?: boolean;
+        preserveExisting?: boolean;
     };
     outDir?: string;
     rootDir?: string;
@@ -167,6 +169,7 @@ export type NormalizedDtsConfig = {
     rewriteAlias?: Record<string, string> | Alias[];
     useInputFiles: boolean;
     clean: boolean;
+    preserveExisting: boolean;
 };
 export type AliasRewriteRule = {
     find: string;

package/types/ssrSharedData/outputPaths.d.ts

@@ -0,0 +1,59 @@
+export declare const SSR_SERVER_OUT_DIR = "ssr-server";
+export declare const SSR_MANIFEST_OUT_DIR = "ssr-manifest";
+export declare const SSR_CLIENT_MANIFEST_FILE = "manifest.json";
+export declare const SSR_CLIENT_URL_PREFIX = "/dist";
+export declare const SSR_PRIVATE_ROOT_DIR = ".tc";
+export declare const SSR_PRIVATE_RUNTIME_DIR = "ssr";
+export type SSRPrivateOutDir = typeof SSR_SERVER_OUT_DIR | typeof SSR_MANIFEST_OUT_DIR;
+/**
+ * 从 Koa public 根目录解析私有 SSR runtime 根目录。
+ *
+ * 例：app/public -> app/.tc/ssr。
+ */
+export declare function resolveSSRPrivateRootFromPublicPath(publicPath: string): string;
+/**
+ * 从 Koa public 根目录解析私有 SSR 子产物目录。
+ */
+export declare function resolveSSRPrivateDir(publicPath: string, subDir: SSRPrivateOutDir): string;
+/**
+ * 将 SSR client 产物相对路径转换成浏览器 URL。
+ */
+export declare function ssrClientAssetUrl(filePath: string): string;
+export type FEOutDirOutput = 'frame' | 'run' | (() => string);
+export interface ResolveFEOutDirOptions {
+    baseDir?: string;
+    output?: FEOutDirOutput;
+}
+export interface ResolveFEOutDirInternalOptions extends ResolveFEOutDirOptions {
+    frameNodePath?: string;
+}
+/**
+ * 解析当前业务项目根目录。
+ */
+export declare function resolveRunPath(options?: Pick<ResolveFEOutDirOptions, 'baseDir'>): string;
+/**
+ * 解析前端 dist 输出目录。
+ */
+export declare function resolveFEOutDir(options?: ResolveFEOutDirInternalOptions): string;
+/**
+ * 从 FE dist 输出目录解析私有 SSR runtime 根目录。
+ *
+ * 例：app/public/dist -> app/.tc/ssr。
+ */
+export declare function resolveSSRPrivateRootFromFEOutDir(feOutDir: string): string;
+/**
+ * 解析私有 SSR server bundle 输出目录。
+ */
+export declare function resolveSSRServerOutDir(options?: ResolveFEOutDirInternalOptions): string;
+/**
+ * 解析共享 client bundle 输出目录。
+ */
+export declare function resolveSSRClientOutDir(options?: ResolveFEOutDirInternalOptions): string;
+/**
+ * 解析私有 SSR client manifest 输出目录。
+ */
+export declare function resolveSSRManifestOutDir(options?: ResolveFEOutDirInternalOptions): string;
+/**
+ * 解析私有 SSR client manifest 文件路径。
+ */
+export declare function resolveSSRManifestFile(options?: ResolveFEOutDirInternalOptions): string;

package/fe/packages/react/hooks/useWatch.test.js

@@ -1,24 +0,0 @@
-import { defaultCompare, identityCompare, shallowCompare } from "./useWatch.js";
-import assert from "node:assert/strict";
-import test from "node:test";
-//#region packages/react/hooks/useWatch.test.ts
-test("defaultCompare treats inline arrays with the same items as equal", () => {
-	assert.equal(defaultCompare([1, "a"], [1, "a"]), true);
-});
-test("defaultCompare detects changed array items", () => {
-	assert.equal(defaultCompare([1, "a"], [1, "b"]), false);
-});
-test("defaultCompare uses identity for object values", () => {
-	assert.equal(defaultCompare({ current: 1 }, { current: 1 }), false);
-});
-test("identityCompare detects changed array references", () => {
-	assert.equal(identityCompare([1, 2], [1, 2]), false);
-});
-test("shallowCompare supports selector array results", () => {
-	assert.equal(shallowCompare([1, 10], [1, 10]), true);
-	assert.equal(shallowCompare([1, 10], [2, 10]), false);
-});
-test("shallowCompare does not treat non-plain objects as equal by empty keys", () => {
-	assert.equal(shallowCompare(/* @__PURE__ */ new Date(0), /* @__PURE__ */ new Date(0)), false);
-});
-//#endregion

package/fe/packages/react/ui/assets/table/no-result.js

@@ -1,4 +0,0 @@
-//#region packages/react/ui/assets/table/no-result.svg
-var no_result_default = "data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='120'%20height='120'%20viewBox='0%200%2024%2024'%20fill='none'%20stroke='currentColor'%20stroke-width='1.5'%20stroke-linecap='round'%20stroke-linejoin='round'%3e%3crect%20x='3'%20y='3'%20width='18'%20height='18'%20rx='2'%20ry='2'/%3e%3cline%20x1='3'%20y1='9'%20x2='21'%20y2='9'/%3e%3cline%20x1='9'%20y1='21'%20x2='9'%20y2='9'/%3e%3c/svg%3e";
-//#endregion
-export { no_result_default as default };

package/fe/packages/react/ui/components/DataTable/dataTableWidth.test.js

@@ -1,39 +0,0 @@
-import { getDataTableColumnStyle, getDataTableColumnWidth, getDataTableFixedOffset, normalizeTableWidth } from "./dataTableWidth.js";
-import assert from "node:assert/strict";
-import test from "node:test";
-//#region packages/react/ui/components/DataTable/dataTableWidth.test.ts
-test("normalizeTableWidth converts numeric widths to px", () => {
-	assert.equal(normalizeTableWidth(160), "160px");
-	assert.equal(normalizeTableWidth("160"), "160px");
-	assert.equal(normalizeTableWidth("160px"), "160px");
-	assert.equal(normalizeTableWidth("calc(100% - 20px)"), "calc(100% - 20px)");
-	assert.equal(normalizeTableWidth(""), void 0);
-});
-test("getDataTableColumnWidth falls back to default and action widths", () => {
-	assert.equal(getDataTableColumnWidth({ key: "name" }, 120), "120px");
-	assert.equal(getDataTableColumnWidth({ key: "action" }, 120), "96px");
-	assert.equal(getDataTableColumnWidth({
-		key: "name",
-		width: "180"
-	}, 120), "180px");
-	assert.equal(getDataTableColumnWidth({
-		key: "name",
-		isAction: true
-	}, 120), "96px");
-});
-test("getDataTableColumnStyle keeps width and minWidth aligned", () => {
-	assert.deepEqual(getDataTableColumnStyle({
-		key: "name",
-		width: "240"
-	}, 120), {
-		width: "240px",
-		minWidth: "240px"
-	});
-	assert.deepEqual(getDataTableColumnStyle({ key: "name" }, 120), { minWidth: "120px" });
-});
-test("getDataTableFixedOffset combines widths in order", () => {
-	assert.equal(getDataTableFixedOffset([]), "0px");
-	assert.equal(getDataTableFixedOffset(["48px"]), "48px");
-	assert.equal(getDataTableFixedOffset(["48px", "120px"]), "calc(48px + 120px)");
-});
-//#endregion

package/fe/packages/react/ui/components/InputNumber/inputNumberUtils.test.js

@@ -1,59 +0,0 @@
-import { clampValue, formatNumber, parseInputNumber, shouldSyncDisplayValue, stepValue } from "./inputNumberUtils.js";
-import assert from "node:assert/strict";
-import test from "node:test";
-//#region packages/react/ui/components/InputNumber/inputNumberUtils.test.ts
-test("parseInputNumber keeps empty and transitional values unresolved", () => {
-	assert.deepEqual(parseInputNumber(""), { kind: "empty" });
-	assert.deepEqual(parseInputNumber("-"), { kind: "incomplete" });
-	assert.deepEqual(parseInputNumber("."), { kind: "incomplete" });
-	assert.deepEqual(parseInputNumber("1."), { kind: "incomplete" });
-	assert.deepEqual(parseInputNumber("-1."), { kind: "incomplete" });
-	assert.deepEqual(parseInputNumber("1.25"), {
-		kind: "number",
-		value: 1.25
-	});
-});
-test("formatNumber applies precision and clamps boundaries", () => {
-	assert.equal(formatNumber(1.236, { precision: 2 }), "1.24");
-	assert.equal(formatNumber(12, { max: 10 }), "10");
-	assert.equal(clampValue(-3, { min: 0 }), 0);
-});
-test("stepValue respects min max precision and step", () => {
-	assert.equal(stepValue(void 0, "up", {
-		step: .25,
-		precision: 2
-	}), .25);
-	assert.equal(stepValue(9.9, "up", {
-		step: 1,
-		max: 10,
-		precision: 1
-	}), 10);
-	assert.equal(stepValue(.3, "down", {
-		step: .2,
-		min: 0,
-		precision: 1
-	}), .1);
-});
-test("shouldSyncDisplayValue preserves editable decimals while focused", () => {
-	assert.equal(shouldSyncDisplayValue({
-		isFocused: true,
-		displayValue: "12.5",
-		currentValue: 12.5
-	}), false);
-	assert.equal(shouldSyncDisplayValue({
-		isFocused: true,
-		displayValue: "12.56",
-		currentValue: 12.56
-	}), false);
-	assert.equal(shouldSyncDisplayValue({
-		isFocused: true,
-		displayValue: "12.56",
-		currentValue: 3.14
-	}), true);
-	assert.equal(shouldSyncDisplayValue({
-		isFocused: false,
-		displayValue: "12.56",
-		currentValue: 12.56
-	}), true);
-});
-//#endregion