feat: Publish sub-namespace OptionalFeature

HISTORY.md

@@ -6,6 +6,11 @@ All notable changes to this project will be documented in this file.
 
 <!-- add unreleased items here -->
 
+* Added
+  * Publish sub-namespace types `OptionalFeature` (via [#1535])
+
+[#1535]: https://github.com/CycloneDX/cyclonedx-javascript-library/pull/1535
+
 ## 10.4.0 -- 2026-11-03
 
 * Added

package.json

@@ -163,6 +163,9 @@
       "default": "./dist.node/index.node.js"
     },
     "./package.json": "./package.json",
+    "./OptionalFeature": {
+      "types": "./dist.d/optionalFeature.d.ts"
+    },
     "./Enums": {
       "types": "./dist.d/enums/index.d.ts",
       "default": "./dist.node/enums/index.js"

src/_optPlug.node/cannot.ts

@@ -17,7 +17,7 @@ SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
-import type { Cannot } from '../_opt'
+import type { Cannot } from '../optionalFeature'
 import { isWillThrow } from './_wrapper'
 
 /**

src/index.common.ts

@@ -17,10 +17,13 @@ SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
+import type * as OptionalFeature from './optionalFeature'
+
 export * as Enums from './enums'
 export * as Models from './models'
 export * as SPDX from './spdx'
 export * as Spec from './spec'
 export * as Types from './types'
+export type { OptionalFeature }
 
 // do not export the _helpers, they are for internal use only

src/_opt.ts → src/optionalFeature.ts

@@ -20,7 +20,7 @@ Copyright (c) OWASP Foundation. All Rights Reserved.
 /**
  * Describes why an optional feature cannot act.
  */
-interface Blocker {
+export interface Blocker {
   readonly message: string
 }
 

src/serialize/jsonSerializer.ts

@@ -17,8 +17,8 @@ SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
-import type * as OptionalFeature from '../_opt'
 import type { Bom } from '../models/bom'
+import type * as OptionalFeature from '../optionalFeature'
 import { Format } from '../spec/enums'
 import { UnsupportedFormatError } from '../spec/errors'
 import { BaseSerializer } from './baseSerializer'

src/serialize/xmlSerializer.node.ts

@@ -17,9 +17,9 @@ SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
-import type * as OptionalFeature from '../_opt'
 import cannotOf from '../_optPlug.node/cannot'
 import stringify from '../_optPlug.node/xmlStringify'
+import type * as OptionalFeature from '../optionalFeature'
 import { MissingOptionalDependencyError } from './errors'
 import type { SerializerOptions } from './types'
 import type { SimpleXml } from './xml/types'

src/serialize/xmlSerializer.web.ts

@@ -18,7 +18,7 @@ Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
 import { isNotUndefined } from '../_helpers/notUndefined'
-import type * as OptionalFeature from '../_opt'
+import type * as OptionalFeature from '../optionalFeature'
 import type { SerializerOptions } from './types'
 import type { SimpleXml } from './xml/types'
 import { XmlBaseSerializer } from './xmlBaseSerializer'

src/validation/jsonValidator.node.ts

@@ -17,9 +17,9 @@ SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
-import type * as OptionalFeature from '../_opt'
 import cannotOf from '../_optPlug.node/cannot'
 import makeValidator, { type Validator } from '../_optPlug.node/jsonValidator'
+import type * as OptionalFeature from '../optionalFeature'
 import { FILES } from '../resources.node'
 import { BaseValidator } from './baseValidator'
 import { MissingOptionalDependencyError, NotImplementedError } from './errors'

src/validation/xmlValidator.node.ts

@@ -17,9 +17,9 @@ SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
 
-import type * as OptionalFeature from '../_opt'
 import cannotOf from '../_optPlug.node/cannot'
 import makeValidator, { type Validator } from '../_optPlug.node/xmlValidator'
+import type * as OptionalFeature from '../optionalFeature'
 import { FILES } from '../resources.node'
 import { BaseValidator } from './baseValidator'
 import { MissingOptionalDependencyError, NotImplementedError } from './errors'

tests/functional/packageManifestExports.node.spec.js

@@ -33,6 +33,13 @@ suite('functional: packageManifest:exports', () => {
     /** @type {Set<string>} */
     const pjRelExported = new Set(
       Object.keys(pjExports)
+        .filter(e => {
+          const ed = pjExports[e]
+          const edT = typeof ed
+          if (edT === 'string') return true
+          if (edT !== 'object') throw new RangeError(`unexpected export definition type for ${e}`)
+          return Object.hasOwn(ed, 'node') || Object.hasOwn(ed, 'default')
+        })
         .filter(e => e.startsWith('./'))
         .map(e => e.substring(2))
     )
@@ -61,7 +68,7 @@ suite('functional: packageManifest:exports', () => {
       }
     })
 
-    suite('does not export internal sobmodules', () => {
+    suite('does not export internal submodules', () => {
       for (const [cdxModName, cdxMod] of Object.entries(CDX)) {
         if (!cdxModName.startsWith('_')) {
           continue // skip non-internal