Skip to content

Commit 7889e2d

Browse files
jdaltonjdalton
committed
refactor: delete 10 empty types.ts placeholder files
Each was a fileoverview comment + zero exports, reserved "for future option records." None had any importers — empty exports were being indexed in package.json, regenerated into docs/api-index.md, and shipped as part of the dist with nothing in them. DELETED (all zero-importer placeholders): - src/abort/types.ts - src/ansi/types.ts - src/arrays/types.ts - src/crypto/types.ts - src/errors/types.ts - src/process/transient-types.ts - src/regexps/types.ts - src/ssri/types.ts - src/streams/types.ts - src/warnings/types.ts When a future change needs a Types interface in one of these dirs, re-add the file then. package.json exports + docs/api-index.md regenerated (10 fewer subpaths exposed).
1 parent 145308e commit 7889e2d

12 files changed

Lines changed: 23 additions & 136 deletions

File tree

‎docs/api-index.md‎

Lines changed: 23 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ Each entry links to the source module and shows the first sentence of its `@file
1212
| Subpath | Description |
1313
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
1414
| [`@socketsecurity/lib/abort/signal`](../src/abort/signal.ts) | Abort signal utilities — composite signal construction from multiple sources and timeout-driven signal creation. |
15-
| [`@socketsecurity/lib/abort/types`](../src/abort/types.ts) | Public type surface for `abort/*` modules — currently no exported types. |
1615

1716
## ai/
1817

@@ -26,11 +25,10 @@ Each entry links to the source module and shows the first sentence of its `@file
2625

2726
## ansi/
2827

29-
| Subpath | Description |
30-
| ---------------------------------------------------------------- | ----------------------------------------------------------------------- |
31-
| [`@socketsecurity/lib/ansi/constants`](../src/ansi/constants.ts) | ANSI escape code constants. |
32-
| [`@socketsecurity/lib/ansi/strip`](../src/ansi/strip.ts) | ANSI escape-code regex factory and stripping helper. |
33-
| [`@socketsecurity/lib/ansi/types`](../src/ansi/types.ts) | Public type surface for `ansi/*` modules — currently no exported types. |
28+
| Subpath | Description |
29+
| ---------------------------------------------------------------- | ---------------------------------------------------- |
30+
| [`@socketsecurity/lib/ansi/constants`](../src/ansi/constants.ts) | ANSI escape code constants. |
31+
| [`@socketsecurity/lib/ansi/strip`](../src/ansi/strip.ts) | ANSI escape-code regex factory and stripping helper. |
3432

3533
## archives/
3634

@@ -57,7 +55,6 @@ Each entry links to the source module and shows the first sentence of its `@file
5755
| [`@socketsecurity/lib/arrays/chunk`](../src/arrays/chunk.ts) | Split an array into fixed-size chunks. |
5856
| [`@socketsecurity/lib/arrays/join`](../src/arrays/join.ts) | Grammatical list joiners via `Intl.ListFormat` — Oxford-comma aware and locale-correct. |
5957
| [`@socketsecurity/lib/arrays/predicates`](../src/arrays/predicates.ts) | Array type-guard predicates. |
60-
| [`@socketsecurity/lib/arrays/types`](../src/arrays/types.ts) | Public type surface for `arrays/*` modules. |
6158
| [`@socketsecurity/lib/arrays/unique`](../src/arrays/unique.ts) | Deduplicate an array via `Set`. |
6259

6360
## bin/
@@ -138,10 +135,9 @@ Each entry links to the source module and shows the first sentence of its `@file
138135

139136
## crypto/
140137

141-
| Subpath | Description |
142-
| ------------------------------------------------------------ | ------------------------------------------------------------------------- |
143-
| [`@socketsecurity/lib/crypto/hash`](../src/crypto/hash.ts) | Crypto hash helpers that prefer Node builtins where available. |
144-
| [`@socketsecurity/lib/crypto/types`](../src/crypto/types.ts) | Public type surface for `crypto/*` modules — currently no exported types. |
138+
| Subpath | Description |
139+
| ---------------------------------------------------------- | -------------------------------------------------------------- |
140+
| [`@socketsecurity/lib/crypto/hash`](../src/crypto/hash.ts) | Crypto hash helpers that prefer Node builtins where available. |
145141

146142
## debug/
147143

@@ -231,12 +227,11 @@ Each entry links to the source module and shows the first sentence of its `@file
231227

232228
## errors/
233229

234-
| Subpath | Description |
235-
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
236-
| [`@socketsecurity/lib/errors/message`](../src/errors/message.ts) | Human-readable error-message extractor. |
237-
| [`@socketsecurity/lib/errors/predicates`](../src/errors/predicates.ts) | Error type-guard predicates — `isError` (with the `isErrorBuiltin` / `isErrorShim` building blocks) and the libuv errno-code narrower `isErrnoException`. |
238-
| [`@socketsecurity/lib/errors/stack`](../src/errors/stack.ts) | Stack-trace extractor with cause-chain support. |
239-
| [`@socketsecurity/lib/errors/types`](../src/errors/types.ts) | Public type surface for `errors/*` modules — currently re-exports nothing; helpers narrow to the standard `Error` / `NodeJS.ErrnoException` types directly. |
230+
| Subpath | Description |
231+
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
232+
| [`@socketsecurity/lib/errors/message`](../src/errors/message.ts) | Human-readable error-message extractor. |
233+
| [`@socketsecurity/lib/errors/predicates`](../src/errors/predicates.ts) | Error type-guard predicates — `isError` (with the `isErrorBuiltin` / `isErrorShim` building blocks) and the libuv errno-code narrower `isErrnoException`. |
234+
| [`@socketsecurity/lib/errors/stack`](../src/errors/stack.ts) | Stack-trace extractor with cause-chain support. |
240235

241236
## fs/
242237

@@ -463,14 +458,13 @@ Each entry links to the source module and shows the first sentence of its `@file
463458

464459
## process/
465460

466-
| Subpath | Description |
467-
| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
468-
| [`@socketsecurity/lib/process/abort`](../src/process/abort.ts) | Process control helpers. |
469-
| [`@socketsecurity/lib/process/lock-instance`](../src/process/lock-instance.ts) | Singleton `processLock` instance — the canonical cross-cutting lock manager. |
470-
| [`@socketsecurity/lib/process/lock-manager`](../src/process/lock-manager.ts) | `ProcessLockManager` — the class that owns active locks, touch timers, and the exit-handler registration. |
471-
| [`@socketsecurity/lib/process/lock-types`](../src/process/lock-types.ts) | Public type surface for `process/lock-*` modules — the `ProcessLockOptions` bag accepted by `processLock.acquire` and `processLock.withLock`. |
472-
| [`@socketsecurity/lib/process/transient`](../src/process/transient.ts) | Temporary package executor detection utilities for Socket ecosystem. |
473-
| [`@socketsecurity/lib/process/transient-types`](../src/process/transient-types.ts) | Public type surface for `process/*` modules — currently no exported types. |
461+
| Subpath | Description |
462+
| ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
463+
| [`@socketsecurity/lib/process/abort`](../src/process/abort.ts) | Process control helpers. |
464+
| [`@socketsecurity/lib/process/lock-instance`](../src/process/lock-instance.ts) | Singleton `processLock` instance — the canonical cross-cutting lock manager. |
465+
| [`@socketsecurity/lib/process/lock-manager`](../src/process/lock-manager.ts) | `ProcessLockManager` — the class that owns active locks, touch timers, and the exit-handler registration. |
466+
| [`@socketsecurity/lib/process/lock-types`](../src/process/lock-types.ts) | Public type surface for `process/lock-*` modules — the `ProcessLockOptions` bag accepted by `processLock.acquire` and `processLock.withLock`. |
467+
| [`@socketsecurity/lib/process/transient`](../src/process/transient.ts) | Temporary package executor detection utilities for Socket ecosystem. |
474468

475469
## promise-queue/
476470

@@ -496,7 +490,6 @@ Each entry links to the source module and shows the first sentence of its `@file
496490
| [`@socketsecurity/lib/regexps/escape`](../src/regexps/escape.ts) | Public `escapeRegExp` entry — binds to native `RegExp.escape` (TC39 Stage 4, Node 24+ / V8 13.7) when available, otherwise falls back to the spec-compliant implementation in `./spec`. |
497491
| [`@socketsecurity/lib/regexps/hex`](../src/regexps/hex.ts) | Hex-encoding helpers — fixed-width `\xHH` (`hex2`) and `\uHHHH` (`hex4`) producers used by the spec-compliant `RegExp.escape` fallback to emit canonical escape sequences. |
498492
| [`@socketsecurity/lib/regexps/spec`](../src/regexps/spec.ts) | Spec-compliant fallback for the TC39 `RegExp.escape` (https://tc39.es/ecma262/#sec-regexp.escape). |
499-
| [`@socketsecurity/lib/regexps/types`](../src/regexps/types.ts) | Public type surface for `regexps/*` modules — currently no exported types. |
500493

501494
## releases/
502495

@@ -584,7 +577,6 @@ Each entry links to the source module and shows the first sentence of its `@file
584577
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
585578
| [`@socketsecurity/lib/ssri/convert`](../src/ssri/convert.ts) | SSRI ↔ hex digest conversion helpers — `hexToSsri` wraps a hex digest in `<algorithm>-<base64>` form, `ssriToHex` decodes the base64 half back to hex. |
586579
| [`@socketsecurity/lib/ssri/parse`](../src/ssri/parse.ts) | SSRI parser — splits a `<algorithm>-<base64hash>` string into its component fields. |
587-
| [`@socketsecurity/lib/ssri/types`](../src/ssri/types.ts) | Public type surface for `ssri/*` modules — currently no exported types. |
588580
| [`@socketsecurity/lib/ssri/validate`](../src/ssri/validate.ts) | SSRI/hex format validators — predicates that report whether a string looks like a hex digest or an SSRI integrity string. |
589581

590582
## stdio/
@@ -602,11 +594,10 @@ Each entry links to the source module and shows the first sentence of its `@file
602594

603595
## streams/
604596

605-
| Subpath | Description |
606-
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
607-
| [`@socketsecurity/lib/streams/parallel`](../src/streams/parallel.ts) | Parallel iteration helpers — `parallelMap()` and the fire-and-forget `parallelEach()`. |
608-
| [`@socketsecurity/lib/streams/transform`](../src/streams/transform.ts) | Streaming transform helper — `transform()` wraps `streaming-iterables.transform` with the project's `pRetry` per-item retry policy. |
609-
| [`@socketsecurity/lib/streams/types`](../src/streams/types.ts) | Public type surface for `streams/*` modules — currently re-exports nothing; stream helpers borrow `IterationOptions` from `promises/types`. |
597+
| Subpath | Description |
598+
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
599+
| [`@socketsecurity/lib/streams/parallel`](../src/streams/parallel.ts) | Parallel iteration helpers — `parallelMap()` and the fire-and-forget `parallelEach()`. |
600+
| [`@socketsecurity/lib/streams/transform`](../src/streams/transform.ts) | Streaming transform helper — `transform()` wraps `streaming-iterables.transform` with the project's `pRetry` per-item retry policy. |
610601

611602
## strings/
612603

@@ -676,7 +667,6 @@ Each entry links to the source module and shows the first sentence of its `@file
676667
| ------------------------------------------------------------------------------ | ------------------------------------------------------------- |
677668
| [`@socketsecurity/lib/warnings/event-target`](../src/warnings/event-target.ts) | Bump the max-listener cap on an EventTarget (or AbortSignal). |
678669
| [`@socketsecurity/lib/warnings/suppress`](../src/warnings/suppress.ts) | `process.emitWarning` suppression. |
679-
| [`@socketsecurity/lib/warnings/types`](../src/warnings/types.ts) | Public type surface for `warnings/*` modules. |
680670

681671
## words/
682672

‎package.json‎

Lines changed: 0 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -103,11 +103,6 @@
103103
"types": "./dist/abort/signal.d.ts",
104104
"default": "./dist/abort/signal.js"
105105
},
106-
"./abort/types": {
107-
"source": "./src/abort/types.ts",
108-
"types": "./dist/abort/types.d.ts",
109-
"default": "./dist/abort/types.js"
110-
},
111106
"./ai/discover": {
112107
"source": "./src/ai/discover.mts",
113108
"types": "./dist/ai/discover.d.mts",
@@ -143,11 +138,6 @@
143138
"types": "./dist/ansi/strip.d.ts",
144139
"default": "./dist/ansi/strip.js"
145140
},
146-
"./ansi/types": {
147-
"source": "./src/ansi/types.ts",
148-
"types": "./dist/ansi/types.d.ts",
149-
"default": "./dist/ansi/types.js"
150-
},
151141
"./archives/detect": {
152142
"source": "./src/archives/detect.ts",
153143
"types": "./dist/archives/detect.d.ts",
@@ -203,11 +193,6 @@
203193
"types": "./dist/arrays/predicates.d.ts",
204194
"default": "./dist/arrays/predicates.js"
205195
},
206-
"./arrays/types": {
207-
"source": "./src/arrays/types.ts",
208-
"types": "./dist/arrays/types.d.ts",
209-
"default": "./dist/arrays/types.js"
210-
},
211196
"./arrays/unique": {
212197
"source": "./src/arrays/unique.ts",
213198
"types": "./dist/arrays/unique.d.ts",
@@ -423,11 +408,6 @@
423408
"types": "./dist/crypto/hash.d.ts",
424409
"default": "./dist/crypto/hash.js"
425410
},
426-
"./crypto/types": {
427-
"source": "./src/crypto/types.ts",
428-
"types": "./dist/crypto/types.d.ts",
429-
"default": "./dist/crypto/types.js"
430-
},
431411
"./debug/caller-info": {
432412
"source": "./src/debug/caller-info.ts",
433413
"types": "./dist/debug/caller-info.d.ts",
@@ -748,11 +728,6 @@
748728
"types": "./dist/errors/stack.d.ts",
749729
"default": "./dist/errors/stack.js"
750730
},
751-
"./errors/types": {
752-
"source": "./src/errors/types.ts",
753-
"types": "./dist/errors/types.d.ts",
754-
"default": "./dist/errors/types.js"
755-
},
756731
"./fs/encoding": {
757732
"source": "./src/fs/encoding.ts",
758733
"types": "./dist/fs/encoding.d.ts",
@@ -1443,11 +1418,6 @@
14431418
"types": "./dist/process/transient.d.ts",
14441419
"default": "./dist/process/transient.js"
14451420
},
1446-
"./process/transient-types": {
1447-
"source": "./src/process/transient-types.ts",
1448-
"types": "./dist/process/transient-types.d.ts",
1449-
"default": "./dist/process/transient-types.js"
1450-
},
14511421
"./promise-queue/queue": {
14521422
"source": "./src/promise-queue/queue.ts",
14531423
"types": "./dist/promise-queue/queue.d.ts",
@@ -1498,11 +1468,6 @@
14981468
"types": "./dist/regexps/spec.d.ts",
14991469
"default": "./dist/regexps/spec.js"
15001470
},
1501-
"./regexps/types": {
1502-
"source": "./src/regexps/types.ts",
1503-
"types": "./dist/regexps/types.d.ts",
1504-
"default": "./dist/regexps/types.js"
1505-
},
15061471
"./releases/github-archives": {
15071472
"source": "./src/releases/github-archives.ts",
15081473
"types": "./dist/releases/github-archives.d.ts",
@@ -1688,11 +1653,6 @@
16881653
"types": "./dist/ssri/parse.d.ts",
16891654
"default": "./dist/ssri/parse.js"
16901655
},
1691-
"./ssri/types": {
1692-
"source": "./src/ssri/types.ts",
1693-
"types": "./dist/ssri/types.d.ts",
1694-
"default": "./dist/ssri/types.js"
1695-
},
16961656
"./ssri/validate": {
16971657
"source": "./src/ssri/validate.ts",
16981658
"types": "./dist/ssri/validate.d.ts",
@@ -1748,11 +1708,6 @@
17481708
"types": "./dist/streams/transform.d.ts",
17491709
"default": "./dist/streams/transform.js"
17501710
},
1751-
"./streams/types": {
1752-
"source": "./src/streams/types.ts",
1753-
"types": "./dist/streams/types.d.ts",
1754-
"default": "./dist/streams/types.js"
1755-
},
17561711
"./strings/format": {
17571712
"source": "./src/strings/format.ts",
17581713
"types": "./dist/strings/format.d.ts",
@@ -1901,11 +1856,6 @@
19011856
"types": "./dist/warnings/suppress.d.ts",
19021857
"default": "./dist/warnings/suppress.js"
19031858
},
1904-
"./warnings/types": {
1905-
"source": "./src/warnings/types.ts",
1906-
"types": "./dist/warnings/types.d.ts",
1907-
"default": "./dist/warnings/types.js"
1908-
},
19091859
"./words/article": {
19101860
"source": "./src/words/article.ts",
19111861
"types": "./dist/words/article.d.ts",

‎src/abort/types.ts‎

Lines changed: 0 additions & 5 deletions
This file was deleted.

‎src/ansi/types.ts‎

Lines changed: 0 additions & 5 deletions
This file was deleted.

0 commit comments

Comments
 (0)