@ux-ui/tsdown-config 0.1.0

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ux-ui.pro
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,64 @@
1
+ # @ux-ui/tsdown-config
2
+
3
+ [tsdown](https://tsdown.dev) config factory for the `ux-ui-pro` npm portfolio. Encodes the §5.1
4
+ library base (`fixedExtension: false`, `minify: false`, `dts` via `tsconfig.build.json`, source
5
+ maps) and the §5.3 CSS-sidecar variant, so each package's `tsdown.config.ts` stays a couple of
6
+ lines and never drifts.
7
+
8
+ ---
9
+
10
+ ## Installation
11
+
12
+ ```bash
13
+ npm install -D @ux-ui/tsdown-config tsdown
14
+ # CSS-sidecar packages (§5.3) additionally:
15
+ npm install -D @tsdown/css sass-embedded
16
+ ```
17
+
18
+ `tsdown` is a peer dependency; `@tsdown/css` is an optional peer (only for CSS libraries).
19
+
20
+ ---
21
+
22
+ ## Usage
23
+
24
+ Standard TS library (§5.1):
25
+
26
+ ```ts
27
+ // tsdown.config.ts
28
+ import { defineLibrary } from '@ux-ui/tsdown-config';
29
+
30
+ export default defineLibrary({ platform: 'browser' });
31
+ ```
32
+
33
+ Web Component + CSS sidecar (§5.3):
34
+
35
+ ```ts
36
+ // tsdown.config.ts
37
+ import { defineCssLibrary } from '@ux-ui/tsdown-config';
38
+
39
+ export default defineCssLibrary({
40
+ cssFileName: 'dialog-lite.css',
41
+ entry: { index: 'src/index.ts', vue: 'src/vue.ts' },
42
+ deps: { neverBundle: ['vue'] },
43
+ });
44
+ ```
45
+
46
+ Overrides are deep-merged onto the base via tsdown's own `mergeConfig`.
47
+
48
+ ---
49
+
50
+ ## API
51
+
52
+ | Export | Signature | Description |
53
+ | --- | --- | --- |
54
+ | `defineLibrary` | `(overrides?: UserConfig) => UserConfig` | §5.1 base + per-package overrides. |
55
+ | `defineCssLibrary` | `({ cssFileName, ...overrides }: CssLibraryOptions) => UserConfig` | §5.1 base + CSS sidecar (§5.3). |
56
+
57
+ `exports` is **not** auto-generated — the portfolio fixes it by hand and validates with
58
+ `publint`/`attw` (§5.1).
59
+
60
+ ---
61
+
62
+ ## License
63
+
64
+ MIT
package/dist/index.cjs ADDED
@@ -0,0 +1,58 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
2
+ let tsdown = require("tsdown");
3
+
4
+ //#region src/index.ts
5
+ /**
6
+ * Shared tsdown base for the ux-ui-pro portfolio (assembly.md §5.1):
7
+ * - `fixedExtension: false` -> `index.js` (ESM) + `index.cjs` (CJS) at `"type": "module"` (§4.3);
8
+ * - `minify: false` -> readable library output (§5.1);
9
+ * - `dts` via `tsconfig.build.json` -> public types only (§4.5/§7);
10
+ * - JS source maps on (§4.9).
11
+ *
12
+ * `exports` is intentionally NOT auto-generated: the portfolio fixes it by hand and validates
13
+ * with publint/attw (§5.1).
14
+ */
15
+ const base = {
16
+ entry: "src/index.ts",
17
+ format: ["esm", "cjs"],
18
+ dts: { tsconfig: "./tsconfig.build.json" },
19
+ fixedExtension: false,
20
+ sourcemap: true,
21
+ minify: false
22
+ };
23
+ /**
24
+ * Standard TS library config (§5.1). Pass `overrides` for per-package tweaks
25
+ * (e.g. `entry`, `platform`, `deps`).
26
+ *
27
+ * @example
28
+ * // tsdown.config.ts
29
+ * import { defineLibrary } from '@ux-ui/tsdown-config';
30
+ * export default defineLibrary({ platform: 'browser' });
31
+ */
32
+ function defineLibrary(overrides = {}) {
33
+ return (0, tsdown.mergeConfig)(base, overrides);
34
+ }
35
+ /**
36
+ * Web Component + CSS sidecar config (§5.3). Adds the CSS pipeline on top of {@link defineLibrary}.
37
+ * Requires `@tsdown/css` (and usually `sass-embedded`) in the consuming package.
38
+ *
39
+ * @example
40
+ * // tsdown.config.ts
41
+ * import { defineCssLibrary } from '@ux-ui/tsdown-config';
42
+ * export default defineCssLibrary({
43
+ * cssFileName: 'dialog-lite.css',
44
+ * entry: { index: 'src/index.ts', vue: 'src/vue.ts' },
45
+ * deps: { neverBundle: ['vue'] },
46
+ * });
47
+ */
48
+ function defineCssLibrary({ cssFileName, ...overrides }) {
49
+ return (0, tsdown.mergeConfig)(base, { css: {
50
+ fileName: cssFileName,
51
+ minify: true
52
+ } }, overrides);
53
+ }
54
+
55
+ //#endregion
56
+ exports.defineCssLibrary = defineCssLibrary;
57
+ exports.defineLibrary = defineLibrary;
58
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { mergeConfig, type UserConfig } from 'tsdown';\n\n/**\n * Shared tsdown base for the ux-ui-pro portfolio (assembly.md §5.1):\n * - `fixedExtension: false` -> `index.js` (ESM) + `index.cjs` (CJS) at `\"type\": \"module\"` (§4.3);\n * - `minify: false` -> readable library output (§5.1);\n * - `dts` via `tsconfig.build.json` -> public types only (§4.5/§7);\n * - JS source maps on (§4.9).\n *\n * `exports` is intentionally NOT auto-generated: the portfolio fixes it by hand and validates\n * with publint/attw (§5.1).\n */\nconst base: UserConfig = {\n entry: 'src/index.ts',\n format: ['esm', 'cjs'],\n dts: { tsconfig: './tsconfig.build.json' },\n fixedExtension: false,\n sourcemap: true,\n minify: false,\n};\n\n/**\n * Standard TS library config (§5.1). Pass `overrides` for per-package tweaks\n * (e.g. `entry`, `platform`, `deps`).\n *\n * @example\n * // tsdown.config.ts\n * import { defineLibrary } from '@ux-ui/tsdown-config';\n * export default defineLibrary({ platform: 'browser' });\n */\nexport function defineLibrary(overrides: UserConfig = {}): UserConfig {\n return mergeConfig(base, overrides);\n}\n\nexport interface CssLibraryOptions extends UserConfig {\n /** Sidecar CSS file name, e.g. `'dialog-lite.css'` (§5.3). */\n cssFileName: string;\n}\n\n/**\n * Web Component + CSS sidecar config (§5.3). Adds the CSS pipeline on top of {@link defineLibrary}.\n * Requires `@tsdown/css` (and usually `sass-embedded`) in the consuming package.\n *\n * @example\n * // tsdown.config.ts\n * import { defineCssLibrary } from '@ux-ui/tsdown-config';\n * export default defineCssLibrary({\n * cssFileName: 'dialog-lite.css',\n * entry: { index: 'src/index.ts', vue: 'src/vue.ts' },\n * deps: { neverBundle: ['vue'] },\n * });\n */\nexport function defineCssLibrary({ cssFileName, ...overrides }: CssLibraryOptions): UserConfig {\n return mergeConfig(base, { css: { fileName: cssFileName, minify: true } }, overrides);\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,OAAmB;CACvB,OAAO;CACP,QAAQ,CAAC,OAAO,KAAK;CACrB,KAAK,EAAE,UAAU,wBAAwB;CACzC,gBAAgB;CAChB,WAAW;CACX,QAAQ;AACV;;;;;;;;;;AAWA,SAAgB,cAAc,YAAwB,CAAC,GAAe;CACpE,+BAAmB,MAAM,SAAS;AACpC;;;;;;;;;;;;;;AAoBA,SAAgB,iBAAiB,EAAE,aAAa,GAAG,aAA4C;CAC7F,+BAAmB,MAAM,EAAE,KAAK;EAAE,UAAU;EAAa,QAAQ;CAAK,EAAE,GAAG,SAAS;AACtF"}
@@ -0,0 +1,37 @@
1
+ import { UserConfig } from "tsdown";
2
+
3
+ //#region src/index.d.ts
4
+ /**
5
+ * Standard TS library config (§5.1). Pass `overrides` for per-package tweaks
6
+ * (e.g. `entry`, `platform`, `deps`).
7
+ *
8
+ * @example
9
+ * // tsdown.config.ts
10
+ * import { defineLibrary } from '@ux-ui/tsdown-config';
11
+ * export default defineLibrary({ platform: 'browser' });
12
+ */
13
+ declare function defineLibrary(overrides?: UserConfig): UserConfig;
14
+ interface CssLibraryOptions extends UserConfig {
15
+ /** Sidecar CSS file name, e.g. `'dialog-lite.css'` (§5.3). */
16
+ cssFileName: string;
17
+ }
18
+ /**
19
+ * Web Component + CSS sidecar config (§5.3). Adds the CSS pipeline on top of {@link defineLibrary}.
20
+ * Requires `@tsdown/css` (and usually `sass-embedded`) in the consuming package.
21
+ *
22
+ * @example
23
+ * // tsdown.config.ts
24
+ * import { defineCssLibrary } from '@ux-ui/tsdown-config';
25
+ * export default defineCssLibrary({
26
+ * cssFileName: 'dialog-lite.css',
27
+ * entry: { index: 'src/index.ts', vue: 'src/vue.ts' },
28
+ * deps: { neverBundle: ['vue'] },
29
+ * });
30
+ */
31
+ declare function defineCssLibrary({
32
+ cssFileName,
33
+ ...overrides
34
+ }: CssLibraryOptions): UserConfig;
35
+ //#endregion
36
+ export { CssLibraryOptions, defineCssLibrary, defineLibrary };
37
+ //# sourceMappingURL=index.d.cts.map
@@ -0,0 +1,37 @@
1
+ import { UserConfig } from "tsdown";
2
+
3
+ //#region src/index.d.ts
4
+ /**
5
+ * Standard TS library config (§5.1). Pass `overrides` for per-package tweaks
6
+ * (e.g. `entry`, `platform`, `deps`).
7
+ *
8
+ * @example
9
+ * // tsdown.config.ts
10
+ * import { defineLibrary } from '@ux-ui/tsdown-config';
11
+ * export default defineLibrary({ platform: 'browser' });
12
+ */
13
+ declare function defineLibrary(overrides?: UserConfig): UserConfig;
14
+ interface CssLibraryOptions extends UserConfig {
15
+ /** Sidecar CSS file name, e.g. `'dialog-lite.css'` (§5.3). */
16
+ cssFileName: string;
17
+ }
18
+ /**
19
+ * Web Component + CSS sidecar config (§5.3). Adds the CSS pipeline on top of {@link defineLibrary}.
20
+ * Requires `@tsdown/css` (and usually `sass-embedded`) in the consuming package.
21
+ *
22
+ * @example
23
+ * // tsdown.config.ts
24
+ * import { defineCssLibrary } from '@ux-ui/tsdown-config';
25
+ * export default defineCssLibrary({
26
+ * cssFileName: 'dialog-lite.css',
27
+ * entry: { index: 'src/index.ts', vue: 'src/vue.ts' },
28
+ * deps: { neverBundle: ['vue'] },
29
+ * });
30
+ */
31
+ declare function defineCssLibrary({
32
+ cssFileName,
33
+ ...overrides
34
+ }: CssLibraryOptions): UserConfig;
35
+ //#endregion
36
+ export { CssLibraryOptions, defineCssLibrary, defineLibrary };
37
+ //# sourceMappingURL=index.d.ts.map
package/dist/index.js ADDED
@@ -0,0 +1,56 @@
1
+ import { mergeConfig } from "tsdown";
2
+
3
+ //#region src/index.ts
4
+ /**
5
+ * Shared tsdown base for the ux-ui-pro portfolio (assembly.md §5.1):
6
+ * - `fixedExtension: false` -> `index.js` (ESM) + `index.cjs` (CJS) at `"type": "module"` (§4.3);
7
+ * - `minify: false` -> readable library output (§5.1);
8
+ * - `dts` via `tsconfig.build.json` -> public types only (§4.5/§7);
9
+ * - JS source maps on (§4.9).
10
+ *
11
+ * `exports` is intentionally NOT auto-generated: the portfolio fixes it by hand and validates
12
+ * with publint/attw (§5.1).
13
+ */
14
+ const base = {
15
+ entry: "src/index.ts",
16
+ format: ["esm", "cjs"],
17
+ dts: { tsconfig: "./tsconfig.build.json" },
18
+ fixedExtension: false,
19
+ sourcemap: true,
20
+ minify: false
21
+ };
22
+ /**
23
+ * Standard TS library config (§5.1). Pass `overrides` for per-package tweaks
24
+ * (e.g. `entry`, `platform`, `deps`).
25
+ *
26
+ * @example
27
+ * // tsdown.config.ts
28
+ * import { defineLibrary } from '@ux-ui/tsdown-config';
29
+ * export default defineLibrary({ platform: 'browser' });
30
+ */
31
+ function defineLibrary(overrides = {}) {
32
+ return mergeConfig(base, overrides);
33
+ }
34
+ /**
35
+ * Web Component + CSS sidecar config (§5.3). Adds the CSS pipeline on top of {@link defineLibrary}.
36
+ * Requires `@tsdown/css` (and usually `sass-embedded`) in the consuming package.
37
+ *
38
+ * @example
39
+ * // tsdown.config.ts
40
+ * import { defineCssLibrary } from '@ux-ui/tsdown-config';
41
+ * export default defineCssLibrary({
42
+ * cssFileName: 'dialog-lite.css',
43
+ * entry: { index: 'src/index.ts', vue: 'src/vue.ts' },
44
+ * deps: { neverBundle: ['vue'] },
45
+ * });
46
+ */
47
+ function defineCssLibrary({ cssFileName, ...overrides }) {
48
+ return mergeConfig(base, { css: {
49
+ fileName: cssFileName,
50
+ minify: true
51
+ } }, overrides);
52
+ }
53
+
54
+ //#endregion
55
+ export { defineCssLibrary, defineLibrary };
56
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { mergeConfig, type UserConfig } from 'tsdown';\n\n/**\n * Shared tsdown base for the ux-ui-pro portfolio (assembly.md §5.1):\n * - `fixedExtension: false` -> `index.js` (ESM) + `index.cjs` (CJS) at `\"type\": \"module\"` (§4.3);\n * - `minify: false` -> readable library output (§5.1);\n * - `dts` via `tsconfig.build.json` -> public types only (§4.5/§7);\n * - JS source maps on (§4.9).\n *\n * `exports` is intentionally NOT auto-generated: the portfolio fixes it by hand and validates\n * with publint/attw (§5.1).\n */\nconst base: UserConfig = {\n entry: 'src/index.ts',\n format: ['esm', 'cjs'],\n dts: { tsconfig: './tsconfig.build.json' },\n fixedExtension: false,\n sourcemap: true,\n minify: false,\n};\n\n/**\n * Standard TS library config (§5.1). Pass `overrides` for per-package tweaks\n * (e.g. `entry`, `platform`, `deps`).\n *\n * @example\n * // tsdown.config.ts\n * import { defineLibrary } from '@ux-ui/tsdown-config';\n * export default defineLibrary({ platform: 'browser' });\n */\nexport function defineLibrary(overrides: UserConfig = {}): UserConfig {\n return mergeConfig(base, overrides);\n}\n\nexport interface CssLibraryOptions extends UserConfig {\n /** Sidecar CSS file name, e.g. `'dialog-lite.css'` (§5.3). */\n cssFileName: string;\n}\n\n/**\n * Web Component + CSS sidecar config (§5.3). Adds the CSS pipeline on top of {@link defineLibrary}.\n * Requires `@tsdown/css` (and usually `sass-embedded`) in the consuming package.\n *\n * @example\n * // tsdown.config.ts\n * import { defineCssLibrary } from '@ux-ui/tsdown-config';\n * export default defineCssLibrary({\n * cssFileName: 'dialog-lite.css',\n * entry: { index: 'src/index.ts', vue: 'src/vue.ts' },\n * deps: { neverBundle: ['vue'] },\n * });\n */\nexport function defineCssLibrary({ cssFileName, ...overrides }: CssLibraryOptions): UserConfig {\n return mergeConfig(base, { css: { fileName: cssFileName, minify: true } }, overrides);\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAM,OAAmB;CACvB,OAAO;CACP,QAAQ,CAAC,OAAO,KAAK;CACrB,KAAK,EAAE,UAAU,wBAAwB;CACzC,gBAAgB;CAChB,WAAW;CACX,QAAQ;AACV;;;;;;;;;;AAWA,SAAgB,cAAc,YAAwB,CAAC,GAAe;CACpE,OAAO,YAAY,MAAM,SAAS;AACpC;;;;;;;;;;;;;;AAoBA,SAAgB,iBAAiB,EAAE,aAAa,GAAG,aAA4C;CAC7F,OAAO,YAAY,MAAM,EAAE,KAAK;EAAE,UAAU;EAAa,QAAQ;CAAK,EAAE,GAAG,SAAS;AACtF"}
package/package.json ADDED
@@ -0,0 +1,83 @@
1
+ {
2
+ "name": "@ux-ui/tsdown-config",
3
+ "version": "0.1.0",
4
+ "description": "tsdown config factory for the ux-ui-pro npm portfolio (assembly.md §5.1/§5.3).",
5
+ "type": "module",
6
+ "author": "ux-ui.pro",
7
+ "license": "MIT",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/ux-ui-pro/tsdown-config.git"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/ux-ui-pro/tsdown-config/issues"
14
+ },
15
+ "homepage": "https://github.com/ux-ui-pro/tsdown-config",
16
+ "sideEffects": false,
17
+ "packageManager": "npm@10.9.3",
18
+ "engines": {
19
+ "node": ">=20.19.0"
20
+ },
21
+ "scripts": {
22
+ "clean": "rimraf dist",
23
+ "build": "tsdown",
24
+ "lint": "biome check src tests tsdown.config.ts",
25
+ "lint:fix": "biome check --write src tests tsdown.config.ts",
26
+ "format": "biome format --write src tests tsdown.config.ts",
27
+ "typecheck": "tsc -p tsconfig.json --noEmit",
28
+ "test:smoke": "node --test \"tests/**/*.js\"",
29
+ "pack:check": "npm pack --dry-run && publint && attw --pack . --profile node16",
30
+ "verify": "npm run lint && npm run typecheck && npm run build && npm run test:smoke && npm run pack:check",
31
+ "prepublishOnly": "npm run clean && npm run verify"
32
+ },
33
+ "source": "src/index.ts",
34
+ "main": "./dist/index.cjs",
35
+ "module": "./dist/index.js",
36
+ "types": "./dist/index.d.ts",
37
+ "exports": {
38
+ ".": {
39
+ "import": {
40
+ "types": "./dist/index.d.ts",
41
+ "default": "./dist/index.js"
42
+ },
43
+ "require": {
44
+ "types": "./dist/index.d.cts",
45
+ "default": "./dist/index.cjs"
46
+ }
47
+ }
48
+ },
49
+ "files": [
50
+ "dist",
51
+ "README.md",
52
+ "LICENSE"
53
+ ],
54
+ "publishConfig": {
55
+ "access": "public"
56
+ },
57
+ "peerDependencies": {
58
+ "@tsdown/css": ">=0.22.3",
59
+ "tsdown": ">=0.21.5"
60
+ },
61
+ "peerDependenciesMeta": {
62
+ "@tsdown/css": {
63
+ "optional": true
64
+ }
65
+ },
66
+ "devDependencies": {
67
+ "@arethetypeswrong/cli": "^0.18.3",
68
+ "@biomejs/biome": "2.4.16",
69
+ "@tsdown/css": "^0.22.3",
70
+ "@types/node": "25.9.2",
71
+ "publint": "^0.3.21",
72
+ "rimraf": "6.1.3",
73
+ "tsdown": "0.22.3",
74
+ "typescript": "6.0.3"
75
+ },
76
+ "keywords": [
77
+ "tsdown",
78
+ "config",
79
+ "build",
80
+ "library",
81
+ "ux-ui-pro"
82
+ ]
83
+ }