@speclynx/apidom-reference 4.2.0 → 4.3.1
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/CHANGELOG.md +11 -0
- package/README.md +327 -0
- package/dist/apidom-reference.browser.js +23493 -21596
- package/dist/apidom-reference.browser.min.js +1 -1
- package/package.json +56 -28
- package/src/configuration/saturated.cjs +47 -36
- package/src/configuration/saturated.mjs +13 -2
- package/src/dereference/strategies/arazzo-1/index.cjs +7 -2
- package/src/dereference/strategies/arazzo-1/index.mjs +8 -3
- package/src/dereference/strategies/overlay-1/extends.cjs +93 -0
- package/src/dereference/strategies/overlay-1/extends.mjs +87 -0
- package/src/dereference/strategies/overlay-1/index.cjs +93 -0
- package/src/dereference/strategies/overlay-1/index.mjs +87 -0
- package/src/parse/parsers/overlay-json-1/extends.cjs +66 -0
- package/src/parse/parsers/overlay-json-1/extends.mjs +60 -0
- package/src/parse/parsers/overlay-json-1/index.cjs +61 -0
- package/src/parse/parsers/overlay-json-1/index.mjs +55 -0
- package/src/parse/parsers/overlay-yaml-1/extends.cjs +6 -0
- package/src/parse/parsers/overlay-yaml-1/extends.mjs +2 -0
- package/src/parse/parsers/overlay-yaml-1/index.cjs +61 -0
- package/src/parse/parsers/overlay-yaml-1/index.mjs +55 -0
- package/src/resolve/strategies/arazzo-1/index.cjs +49 -0
- package/src/resolve/strategies/arazzo-1/index.mjs +43 -0
- package/src/resolve/strategies/overlay-1/index.cjs +49 -0
- package/src/resolve/strategies/overlay-1/index.mjs +43 -0
- package/types/dereference/strategies/overlay-1/extends.d.ts +21 -0
- package/types/dereference/strategies/overlay-1/index.d.ts +28 -0
- package/types/parse/parsers/overlay-json-1/extends.d.ts +16 -0
- package/types/parse/parsers/overlay-json-1/index.d.ts +22 -0
- package/types/parse/parsers/overlay-yaml-1/extends.d.ts +1 -0
- package/types/parse/parsers/overlay-yaml-1/index.d.ts +22 -0
- package/types/resolve/strategies/arazzo-1/index.d.ts +27 -0
- package/types/resolve/strategies/overlay-1/index.d.ts +27 -0
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { Element } from '@speclynx/apidom-datamodel';
|
|
2
|
+
import DereferenceStrategy, { DereferenceStrategyOptions } from '../DereferenceStrategy.ts';
|
|
3
|
+
import File from '../../../File.ts';
|
|
4
|
+
import type { ReferenceOptions } from '../../../options/index.ts';
|
|
5
|
+
export type { default as DereferenceStrategy, DereferenceStrategyOptions, } from '../DereferenceStrategy.ts';
|
|
6
|
+
export type { default as File, FileOptions } from '../../../File.ts';
|
|
7
|
+
export type { default as Reference, ReferenceOptions } from '../../../Reference.ts';
|
|
8
|
+
export type { default as ReferenceSet, ReferenceSetOptions } from '../../../ReferenceSet.ts';
|
|
9
|
+
export type { ReferenceOptions as ApiDOMReferenceOptions, ReferenceBundleOptions as ApiDOMReferenceBundleOptions, ReferenceDereferenceOptions as ApiDOMReferenceDereferenceOptions, ReferenceParseOptions as ApiDOMReferenceParseOptions, ReferenceResolveOptions as ApiDOMReferenceResolveOptions, } from '../../../options/index.ts';
|
|
10
|
+
export type { default as Parser, ParserOptions } from '../../../parse/parsers/Parser.ts';
|
|
11
|
+
export type { default as Resolver, ResolverOptions } from '../../../resolve/resolvers/Resolver.ts';
|
|
12
|
+
export type { default as ResolveStrategy, ResolveStrategyOptions, } from '../../../resolve/strategies/ResolveStrategy.ts';
|
|
13
|
+
export type { default as BundleStrategy, BundleStrategyOptions, } from '../../../bundle/strategies/BundleStrategy.ts';
|
|
14
|
+
/**
|
|
15
|
+
* @public
|
|
16
|
+
*/
|
|
17
|
+
export interface Overlay1DereferenceStrategyOptions extends Omit<DereferenceStrategyOptions, 'name'> {
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* @public
|
|
21
|
+
*/
|
|
22
|
+
declare class Overlay1DereferenceStrategy extends DereferenceStrategy {
|
|
23
|
+
constructor(options?: Overlay1DereferenceStrategyOptions);
|
|
24
|
+
canDereference(file: File): boolean;
|
|
25
|
+
dereference(file: File, options: ReferenceOptions): Promise<Element>;
|
|
26
|
+
}
|
|
27
|
+
export { dereferenceExtends } from './extends.ts';
|
|
28
|
+
export default Overlay1DereferenceStrategy;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { ParseResultElement } from '@speclynx/apidom-datamodel';
|
|
2
|
+
import type { ReferenceOptions } from '../../../options/index.ts';
|
|
3
|
+
/**
|
|
4
|
+
* Parses the `extends` target document from an Overlay document's ParseResult.
|
|
5
|
+
*
|
|
6
|
+
* The parsed extends document is pushed directly into the overlay's ParseResult
|
|
7
|
+
* and always attached to the extends element's meta as 'parseResult',
|
|
8
|
+
* regardless of success or failure.
|
|
9
|
+
*
|
|
10
|
+
* @param parseResult - ParseResult containing an Overlay specification
|
|
11
|
+
* @param parseResultRetrievalURI - URI from which the parseResult was retrieved
|
|
12
|
+
* @param options - Full ReferenceOptions
|
|
13
|
+
*
|
|
14
|
+
* @public
|
|
15
|
+
*/
|
|
16
|
+
export declare function parseExtends(parseResult: ParseResultElement, parseResultRetrievalURI: string, options: ReferenceOptions): Promise<void>;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { ParseResultElement } from '@speclynx/apidom-datamodel';
|
|
2
|
+
import Parser, { ParserOptions } from '../Parser.ts';
|
|
3
|
+
import File from '../../../File.ts';
|
|
4
|
+
import type { ReferenceOptions } from '../../../options/index.ts';
|
|
5
|
+
export type { default as Parser, ParserOptions } from '../Parser.ts';
|
|
6
|
+
export type { default as File, FileOptions } from '../../../File.ts';
|
|
7
|
+
/**
|
|
8
|
+
* @public
|
|
9
|
+
*/
|
|
10
|
+
export interface OverlayJSON1ParserOptions extends Omit<ParserOptions, 'name'> {
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* @public
|
|
14
|
+
*/
|
|
15
|
+
declare class OverlayJSON1Parser extends Parser {
|
|
16
|
+
refractorOpts: object;
|
|
17
|
+
constructor(options?: OverlayJSON1ParserOptions);
|
|
18
|
+
canParse(file: File): Promise<boolean>;
|
|
19
|
+
parse(file: File, options?: ReferenceOptions): Promise<ParseResultElement>;
|
|
20
|
+
}
|
|
21
|
+
export { parseExtends } from './extends.ts';
|
|
22
|
+
export default OverlayJSON1Parser;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { parseExtends } from '../overlay-json-1/extends.ts';
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { ParseResultElement } from '@speclynx/apidom-datamodel';
|
|
2
|
+
import Parser, { ParserOptions } from '../Parser.ts';
|
|
3
|
+
import File from '../../../File.ts';
|
|
4
|
+
import type { ReferenceOptions } from '../../../options/index.ts';
|
|
5
|
+
export type { default as Parser, ParserOptions } from '../Parser.ts';
|
|
6
|
+
export type { default as File, FileOptions } from '../../../File.ts';
|
|
7
|
+
/**
|
|
8
|
+
* @public
|
|
9
|
+
*/
|
|
10
|
+
export interface OverlayYAML1ParserOptions extends Omit<ParserOptions, 'name'> {
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* @public
|
|
14
|
+
*/
|
|
15
|
+
declare class OverlayYAML1Parser extends Parser {
|
|
16
|
+
refractorOpts: object;
|
|
17
|
+
constructor(options?: OverlayYAML1ParserOptions);
|
|
18
|
+
canParse(file: File): Promise<boolean>;
|
|
19
|
+
parse(file: File, options?: ReferenceOptions): Promise<ParseResultElement>;
|
|
20
|
+
}
|
|
21
|
+
export { parseExtends } from './extends.ts';
|
|
22
|
+
export default OverlayYAML1Parser;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import ResolveStrategy, { ResolveStrategyOptions } from '../ResolveStrategy.ts';
|
|
2
|
+
import ReferenceSet from '../../../ReferenceSet.ts';
|
|
3
|
+
import File from '../../../File.ts';
|
|
4
|
+
import type { ReferenceOptions } from '../../../options/index.ts';
|
|
5
|
+
export type { default as ResolveStrategy, ResolveStrategyOptions } from '../ResolveStrategy.ts';
|
|
6
|
+
export type { default as ReferenceSet, ReferenceSetOptions } from '../../../ReferenceSet.ts';
|
|
7
|
+
export type { default as File, FileOptions } from '../../../File.ts';
|
|
8
|
+
export type { ReferenceOptions as ApiDOMReferenceOptions, ReferenceBundleOptions as ApiDOMReferenceBundleOptions, ReferenceDereferenceOptions as ApiDOMReferenceDereferenceOptions, ReferenceParseOptions as ApiDOMReferenceParseOptions, ReferenceResolveOptions as ApiDOMReferenceResolveOptions, } from '../../../options/index.ts';
|
|
9
|
+
export type { default as Parser, ParserOptions } from '../../../parse/parsers/Parser.ts';
|
|
10
|
+
export type { default as Resolver, ResolverOptions } from '../../resolvers/Resolver.ts';
|
|
11
|
+
export type { default as DereferenceStrategy, DereferenceStrategyOptions, } from '../../../dereference/strategies/DereferenceStrategy.ts';
|
|
12
|
+
export type { default as BundleStrategy, BundleStrategyOptions, } from '../../../bundle/strategies/BundleStrategy.ts';
|
|
13
|
+
export type { default as Reference, ReferenceOptions } from '../../../Reference.ts';
|
|
14
|
+
/**
|
|
15
|
+
* @public
|
|
16
|
+
*/
|
|
17
|
+
export interface Arazzo1ResolveStrategyOptions extends Omit<ResolveStrategyOptions, 'name'> {
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* @public
|
|
21
|
+
*/
|
|
22
|
+
declare class Arazzo1ResolveStrategy extends ResolveStrategy {
|
|
23
|
+
constructor(options?: Arazzo1ResolveStrategyOptions);
|
|
24
|
+
canResolve(file: File, options: ReferenceOptions): boolean;
|
|
25
|
+
resolve(file: File, options: ReferenceOptions): Promise<ReferenceSet>;
|
|
26
|
+
}
|
|
27
|
+
export default Arazzo1ResolveStrategy;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import ResolveStrategy, { ResolveStrategyOptions } from '../ResolveStrategy.ts';
|
|
2
|
+
import ReferenceSet from '../../../ReferenceSet.ts';
|
|
3
|
+
import File from '../../../File.ts';
|
|
4
|
+
import type { ReferenceOptions } from '../../../options/index.ts';
|
|
5
|
+
export type { default as ResolveStrategy, ResolveStrategyOptions } from '../ResolveStrategy.ts';
|
|
6
|
+
export type { default as ReferenceSet, ReferenceSetOptions } from '../../../ReferenceSet.ts';
|
|
7
|
+
export type { default as File, FileOptions } from '../../../File.ts';
|
|
8
|
+
export type { ReferenceOptions as ApiDOMReferenceOptions, ReferenceBundleOptions as ApiDOMReferenceBundleOptions, ReferenceDereferenceOptions as ApiDOMReferenceDereferenceOptions, ReferenceParseOptions as ApiDOMReferenceParseOptions, ReferenceResolveOptions as ApiDOMReferenceResolveOptions, } from '../../../options/index.ts';
|
|
9
|
+
export type { default as Parser, ParserOptions } from '../../../parse/parsers/Parser.ts';
|
|
10
|
+
export type { default as Resolver, ResolverOptions } from '../../resolvers/Resolver.ts';
|
|
11
|
+
export type { default as DereferenceStrategy, DereferenceStrategyOptions, } from '../../../dereference/strategies/DereferenceStrategy.ts';
|
|
12
|
+
export type { default as BundleStrategy, BundleStrategyOptions, } from '../../../bundle/strategies/BundleStrategy.ts';
|
|
13
|
+
export type { default as Reference, ReferenceOptions } from '../../../Reference.ts';
|
|
14
|
+
/**
|
|
15
|
+
* @public
|
|
16
|
+
*/
|
|
17
|
+
export interface Overlay1ResolveStrategyOptions extends Omit<ResolveStrategyOptions, 'name'> {
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* @public
|
|
21
|
+
*/
|
|
22
|
+
declare class Overlay1ResolveStrategy extends ResolveStrategy {
|
|
23
|
+
constructor(options?: Overlay1ResolveStrategyOptions);
|
|
24
|
+
canResolve(file: File, options: ReferenceOptions): boolean;
|
|
25
|
+
resolve(file: File, options: ReferenceOptions): Promise<ReferenceSet>;
|
|
26
|
+
}
|
|
27
|
+
export default Overlay1ResolveStrategy;
|