@pkistudio/asn1defsifter 0.1.0

package/dist/styles.css

@@ -0,0 +1 @@
+:root{--ads-bg-start: #f5f7fa;--ads-bg: #e8edf3;--ads-window: #eef2f6;--ads-chrome-start: #ffffff;--ads-chrome: #eef3f8;--ads-chrome-glass: linear-gradient(180deg, rgb(255 255 255 / 66%), rgb(238 243 248 / 42%));--ads-panel: rgb(255 255 255 / 72%);--ads-panel-tint: rgb(247 249 252 / 54%);--ads-content: rgb(255 255 255 / 46%);--ads-card: rgb(255 255 255 / 68%);--ads-glass: linear-gradient(180deg, rgb(255 255 255 / 58%), rgb(247 249 252 / 34%));--ads-panel-border: #b9c4d0;--ads-control-border: #aab6c3;--ads-subtle-border: #d6dee6;--ads-text: #18212f;--ads-muted: #5d6b7c;--ads-danger: #a83232;--ads-hover-border: #81a9dc;--ads-hover-bg: #e6f2ff;--ads-selection: #e8f3ff;--ads-selection-border: #5d91cc;--ads-splitter: #8f9baa;--ads-shadow-dialog: 0 18px 50px rgb(15 23 42 / 28%);--ads-api-log-row-border: #edf0f4;--ads-api-log-operation: #1f4f86;color:var(--ads-text);background:linear-gradient(var(--ads-bg-start),var(--ads-bg));font-family:Tahoma,MS UI Gothic,Yu Gothic UI,system-ui,sans-serif;font-size:13px}@media(prefers-color-scheme:dark){:root{--ads-bg-start: #242a33;--ads-bg: #171b22;--ads-window: rgb(37 43 52 / 72%);--ads-chrome-start: #303743;--ads-chrome: #252c36;--ads-chrome-glass: linear-gradient(180deg, rgb(48 55 67 / 54%), rgb(37 44 54 / 34%));--ads-panel: rgb(37 43 52 / 56%);--ads-panel-tint: rgb(26 31 39 / 42%);--ads-content: rgb(20 24 31 / 36%);--ads-card: rgb(43 50 60 / 58%);--ads-glass: linear-gradient(180deg, rgb(48 55 67 / 48%), rgb(25 30 38 / 26%));--ads-panel-border: #4f5a68;--ads-control-border: #657180;--ads-subtle-border: rgb(119 132 150 / 42%);--ads-text: #e7ebf1;--ads-muted: #aab3c1;--ads-danger: #ff9c9c;--ads-hover-border: #81a9dc;--ads-hover-bg: rgb(74 102 135 / 42%);--ads-selection: rgb(47 88 126 / 62%);--ads-selection-border: #6ea5da;--ads-splitter: #6b7786;--ads-api-log-row-border: rgb(119 132 150 / 26%);--ads-api-log-operation: #9ec9ff}}.ads-shell{color:var(--ads-text)}.ads-shell[data-theme=dark]{--ads-bg-start: #242a33;--ads-bg: #171b22;--ads-window: rgb(37 43 52 / 72%);--ads-chrome-start: #303743;--ads-chrome: #252c36;--ads-chrome-glass: linear-gradient(180deg, rgb(48 55 67 / 54%), rgb(37 44 54 / 34%));--ads-panel: rgb(37 43 52 / 56%);--ads-panel-tint: rgb(26 31 39 / 42%);--ads-content: rgb(20 24 31 / 36%);--ads-card: rgb(43 50 60 / 58%);--ads-glass: linear-gradient(180deg, rgb(48 55 67 / 48%), rgb(25 30 38 / 26%));--ads-panel-border: #4f5a68;--ads-control-border: #657180;--ads-subtle-border: rgb(119 132 150 / 42%);--ads-text: #e7ebf1;--ads-muted: #aab3c1;--ads-danger: #ff9c9c;--ads-hover-border: #81a9dc;--ads-hover-bg: rgb(74 102 135 / 42%);--ads-selection: rgb(47 88 126 / 62%);--ads-selection-border: #6ea5da;--ads-splitter: #6b7786;--ads-api-log-row-border: rgb(119 132 150 / 26%);--ads-api-log-operation: #9ec9ff}*{box-sizing:border-box}html,body{width:100%;height:100%;min-height:0;overflow-x:auto;overflow-y:hidden}body{margin:0;min-width:var(--ads-app-min-width, 640px)}#app{width:100%;height:100dvh;min-width:var(--ads-app-min-width, 640px);min-height:0}button{min-height:0;border:1px solid transparent;border-radius:3px;padding:4px 10px;color:var(--ads-text);background:transparent;font:inherit;cursor:pointer}button:hover,button:focus-visible{border-color:var(--ads-hover-border);background:var(--ads-hover-bg);outline:none}.ads-shell{display:grid;grid-template-rows:auto minmax(220px,1fr) 6px minmax(150px,var(--ads-selected-height, 30vh)) 6px minmax(86px,var(--ads-api-log-height, 156px));width:100%;height:100%;min-width:var(--ads-app-min-width, 640px);min-height:0;overflow:hidden;background:linear-gradient(var(--ads-bg-start),var(--ads-bg))}.ads-shell.ads-resizing-rows{cursor:row-resize;-webkit-user-select:none;user-select:none}.ads-shell.ads-resizing-columns{cursor:col-resize;-webkit-user-select:none;user-select:none}.ads-toolbar{display:flex;align-items:center;justify-content:flex-start;gap:8px;border:1px solid var(--ads-panel-border);border-bottom:0;padding:4px;background:var(--ads-chrome-glass)}.ads-toolbar strong{margin:0;padding:4px 8px;font-size:13px;font-weight:700}.ads-workspace{display:grid;grid-template-columns:minmax(280px,var(--ads-viewer-width, 42%)) 6px minmax(320px,1fr);gap:0;min-height:0;overflow:hidden;border:1px solid var(--ads-panel-border);border-bottom:0;padding:8px 8px 6px;background:var(--ads-window)}.ads-pane,.ads-viewer-pane,.ads-log-pane{display:flex;flex-direction:column;min-width:0;min-height:0;border:1px solid var(--ads-panel-border);border-radius:3px;background:var(--ads-glass);overflow:hidden}.ads-viewer-pane{flex:1 1 auto;margin-right:6px;border:0;border-radius:0;background:transparent}.ads-candidate-pane{margin-left:6px;border:0;border-radius:0;background:transparent}.ads-candidate-pane .ads-pane-content{border:0;background:transparent}.ads-pane-menu,.ads-log-menu{display:flex;align-items:center;gap:2px;min-height:0;padding:4px;border-bottom:1px solid var(--ads-subtle-border);color:var(--ads-text);background:linear-gradient(var(--ads-chrome-start),var(--ads-chrome))}.ads-pane-menu strong,.ads-log-menu strong{margin-right:auto;padding:4px 6px;font-size:12px;font-weight:650;letter-spacing:0}.ads-log-menu{justify-content:flex-end;min-height:32px;padding:0 6px 4px;border-bottom:0;background:transparent}.ads-log-menu button{min-height:24px;border-color:transparent;padding:2px 8px;background:transparent}.ads-log-menu button:hover,.ads-log-menu button:focus-visible{border-color:var(--ads-hover-border);background:var(--ads-hover-bg);outline:none}.ads-pane-content{flex:1 1 auto;min-height:0;overflow:auto;margin:8px;border:1px solid var(--ads-subtle-border);border-radius:3px;background:var(--ads-content);padding:10px}.ads-input-viewer{flex:1 1 auto;width:100%;height:100%;min-height:0;overflow:hidden;background:transparent}.ads-workspace-resizer{min-width:6px;border:1px solid transparent;border-radius:3px;background:linear-gradient(90deg,transparent 0 2px,var(--ads-splitter) 2px 3px,transparent 3px 6px);cursor:col-resize}.ads-workspace-resizer:hover,.ads-workspace-resizer:focus-visible,.ads-shell.ads-resizing-columns .ads-workspace-resizer{border-color:var(--ads-hover-border);background-color:var(--ads-hover-bg);outline:none}.ads-notice{flex:0 0 auto;width:100%;min-height:28px;padding:4px 10px 6px;border-top:0;color:var(--ads-muted);background:transparent;font-size:12px;line-height:1.35}.ads-tree{background:var(--ads-content)}.ads-candidate-split{display:flex;flex-direction:column;flex:1 1 auto;min-height:0}.ads-tree-node{margin:0 0 6px}.ads-tree-node summary{position:relative;display:grid;grid-template-columns:12px 18px minmax(0,1fr) auto;gap:5px;align-items:center;min-height:32px;border:1px solid var(--ads-subtle-border);border-radius:3px;padding:5px 8px;background:var(--ads-card);cursor:pointer}.ads-tree-node summary::marker,.ads-tree-node summary::-webkit-details-marker{display:none;content:""}.ads-tree-item{display:grid;grid-template-columns:12px 18px minmax(0,1fr) auto;gap:5px;align-items:center;width:100%;min-height:32px;margin:0 0 6px;border:1px solid var(--ads-subtle-border);border-radius:3px;padding:5px 8px;background:var(--ads-card);text-align:left}.ads-tree-alternatives{position:absolute;top:calc(100% + 2px);left:28px;right:8px;z-index:20;max-height:220px;overflow:auto;border:1px solid var(--ads-panel-border);border-radius:3px;padding:4px;background:var(--ads-panel);box-shadow:0 8px 18px #1e293b29}.ads-tree-alternatives[hidden]{display:none}.ads-tree-alternatives .ads-tree-item{grid-template-columns:14px minmax(0,1fr) auto;margin:0;border-color:transparent;box-shadow:none}.ads-tree-alternatives .ads-tree-item:hover,.ads-tree-alternatives .ads-tree-item:focus-visible{border-color:#b6d5f0;background:var(--ads-hover-bg)}.ads-tree-checkmark{display:inline-flex;align-items:center;justify-content:center;width:14px;color:#1f6f43;font-weight:700}.ads-disclosure{display:inline-flex;align-items:center;justify-content:center;width:11px;height:11px;border:1px solid #7f8b97;color:var(--ads-text);background:var(--ads-panel);font-size:10px;line-height:1}.ads-disclosure:before{content:""}details:not([open])>summary>.ads-disclosure:before{content:"+"}details[open]>summary>.ads-disclosure:before{content:"-"}.ads-disclosure-hidden{border-color:transparent;background:transparent;visibility:hidden}.ads-tree-icon{position:relative;display:inline-block;width:16px;height:14px}.ads-tree-icon-branch:before{position:absolute;top:1px;left:1px;width:7px;height:4px;border:1px solid #c29018;border-bottom:0;background:#ffd35a;content:""}.ads-tree-icon-branch:after{position:absolute;top:4px;left:0;width:15px;height:9px;border:1px solid #c29018;background:#ffc83d;content:""}.ads-tree-icon-leaf:before{position:absolute;top:1px;left:3px;width:10px;height:12px;border:1px solid #9ca7b3;background:var(--ads-panel);box-shadow:inset -3px 3px #eef2f6;content:""}.ads-tree-selected{border-color:var(--ads-selection-border)!important;background:var(--ads-selection)!important}.ads-subtree-node summary{background:color-mix(in srgb,var(--ads-panel) 94%,var(--ads-text) 6%)}.ads-candidate-node summary{background:var(--ads-card)}.ads-tree-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-weight:600}.ads-tree-note{color:var(--ads-muted);font-size:12px;white-space:nowrap}.ads-tree-children{margin:6px 0 0 14px;padding-left:10px;border-left:1px solid var(--ads-subtle-border)}.ads-selected-pane{display:flex;flex-direction:column;min-width:0;min-height:0;border:0;border-radius:0;background:transparent;overflow:hidden}.ads-selected-header{display:grid;grid-template-columns:auto minmax(0,1fr) auto;gap:10px;align-items:center;min-height:34px;padding:4px;border:1px solid var(--ads-subtle-border);border-radius:3px;background:var(--ads-chrome-glass);font-size:12px}.ads-selected-header strong{padding:4px 6px}.ads-selected-header span{overflow:hidden;color:var(--ads-muted);text-overflow:ellipsis;white-space:nowrap}.ads-selected-header button{min-height:24px;padding:2px 8px}.ads-selected-detail{display:flex;flex:1 1 auto;flex-wrap:wrap;gap:8px;align-content:start;min-height:0;overflow-y:auto;overflow-x:hidden;margin:8px;border:0;border-radius:0;padding:10px;color:var(--ads-muted);background:transparent}.ads-key-value{flex:0 1 max-content;min-width:0;max-width:100%;border:1px solid var(--ads-subtle-border);border-radius:3px;background:var(--ads-card)}.ads-key-value h3{margin:0;padding:6px 8px;border-bottom:1px solid var(--ads-subtle-border);color:var(--ads-text);font-size:12px;white-space:nowrap}.ads-key-value pre{margin:0;padding:8px;overflow:visible;white-space:pre;overflow-wrap:normal;color:var(--ads-text);font-family:Consolas,Courier New,monospace;font-size:12px;line-height:1.45}.ads-key-value-bytes pre{white-space:pre-wrap;overflow-wrap:anywhere}.ads-key-value-bytes{flex:1 1 calc(14ch + 18px);min-width:calc(14ch + 18px)}.ads-api-log{display:grid;align-content:start;flex:1 1 auto;min-width:0;min-height:0;margin:0;overflow:auto;padding:5px 6px;color:var(--ads-text);background:transparent;font-family:Consolas,Courier New,monospace;font-size:12px;line-height:1.35;list-style:none}.ads-api-log-entry{display:grid;grid-template-columns:174px minmax(150px,220px) minmax(0,1fr);gap:8px;align-items:baseline;min-width:0;padding:2px 0;border-bottom:1px solid var(--ads-api-log-row-border)}.ads-api-log-entry time{color:var(--ads-muted)}.ads-api-log-operation{color:var(--ads-api-log-operation);overflow-wrap:anywhere}.ads-api-log-detail{min-width:0;overflow-wrap:anywhere}.ads-api-log-entry.success .ads-api-log-operation{color:#1f6f43}.ads-api-log-entry.warning .ads-api-log-operation,.ads-api-log-entry.warning .ads-api-log-detail{color:#806000}.ads-api-log-entry.error .ads-api-log-operation,.ads-api-log-entry.error .ads-api-log-detail{color:var(--ads-danger)}.ads-log-pane{border:0;border-radius:0;background:var(--ads-window)}.ads-selected-pane-resizer,.ads-api-log-resizer{min-height:6px;border:1px solid transparent;border-radius:3px;background:linear-gradient(0deg,transparent 0 2px,var(--ads-splitter) 2px 3px,transparent 3px 6px);cursor:row-resize}.ads-selected-pane-resizer:hover,.ads-selected-pane-resizer:focus-visible,.ads-api-log-resizer:hover,.ads-api-log-resizer:focus-visible,.ads-shell.ads-resizing-rows .ads-selected-pane-resizer,.ads-shell.ads-resizing-rows .ads-api-log-resizer{border-color:var(--ads-hover-border);background-color:var(--ads-hover-bg);outline:none}.ads-about-dialog{width:min(380px,calc(100% - 32px));margin:auto;border:1px solid var(--ads-panel-border);border-radius:4px;padding:0;color:var(--ads-text);background:var(--ads-panel);box-shadow:var(--ads-shadow-dialog)}.ads-about-dialog::backdrop{background:#0f172a47}.ads-about-panel{display:grid;gap:12px;padding:14px}.ads-about-panel p{margin:0;color:var(--ads-muted);font-size:12px;line-height:1.45}.ads-about-name{font-weight:700}.ads-about-module{margin-top:2px;color:var(--ads-muted);font-size:12px}.ads-about-panel form{display:flex;justify-content:flex-end;margin:0}@media(max-width:640px){.ads-shell{grid-template-rows:auto minmax(220px,1fr) 6px minmax(160px,var(--ads-selected-height, 32vh)) 6px minmax(86px,var(--ads-api-log-height, 180px))}.ads-workspace{grid-template-columns:1fr;grid-template-rows:minmax(220px,42%) minmax(260px,1fr);overflow:auto}.ads-workspace-resizer{display:none}.ads-viewer-pane,.ads-candidate-pane{margin:0}.ads-api-log-entry{grid-template-columns:174px minmax(0,1fr)}.ads-api-log-detail{grid-column:1 / -1}}

package/dist/types/adapters/asn1instancebuilder.d.ts

@@ -0,0 +1,2 @@
+import type { SchemaCorpus } from '../core/types.js';
+export declare function parseAsn1DefinitionCorpus(sources: string | string[]): SchemaCorpus;

package/dist/types/adapters/pkistudiojs.d.ts

@@ -0,0 +1,23 @@
+import type { TlvNode } from '../core/types.js';
+interface PkiStudioLikeNode {
+    id?: string;
+    tagClass?: string | number;
+    className?: string;
+    tagNumber?: number;
+    tag?: number;
+    tagName?: string;
+    constructed?: boolean;
+    isConstructed?: boolean;
+    valueBytes?: Uint8Array | number[];
+    contentBytes?: Uint8Array | number[];
+    bytes?: Uint8Array | number[];
+    value?: unknown;
+    oid?: string;
+    oidValue?: string;
+    children?: PkiStudioLikeNode[];
+    start?: number;
+    end?: number;
+}
+export declare function parseInputToTlvNodes(input: unknown, options?: Record<string, unknown>): Promise<TlvNode[]>;
+export declare function pkistudioNodeToTlvNode(node: PkiStudioLikeNode): TlvNode;
+export {};

package/dist/types/app.d.ts

@@ -0,0 +1,32 @@
+import './styles.css';
+import { type CandidateReport } from './core/index.js';
+export type AppTheme = 'light' | 'dark';
+export type Asn1DefinitionSifterAppOptions = {
+    mount?: string | Element;
+    theme?: AppTheme;
+    viewer?: {
+        oidResolver?: PkiStudioOidResolverApi | ((oid: string) => string);
+        newWindowUrl?: string;
+    };
+};
+export type Asn1DefinitionSifterAppInstance = {
+    readonly report: CandidateReport | null;
+    readonly sourceName: string | null;
+    loadBytes: (bytes: Uint8Array, sourceName?: string) => Promise<void>;
+    loadHex: (hex: string, sourceName?: string) => Promise<void>;
+    close: () => void;
+};
+type PkiStudioOidResolverApi = {
+    names: Record<string, string>;
+    resolve: (oid: string) => string;
+    create: (extraNames?: Record<string, string>) => PkiStudioOidResolverApi;
+};
+declare global {
+    interface Window {
+        Asn1DefinitionSifter?: {
+            init: typeof initAsn1DefinitionSifter;
+        };
+    }
+}
+export declare function initAsn1DefinitionSifter(options?: Asn1DefinitionSifterAppOptions): Asn1DefinitionSifterAppInstance;
+export {};

package/dist/types/core/annotated-tree.d.ts

@@ -0,0 +1,2 @@
+import type { AnnotatedNode, Candidate, TlvNode } from './types.js';
+export declare function createAnnotatedTree(node: TlvNode, candidate?: Candidate): AnnotatedNode[];

package/dist/types/core/candidates.d.ts

@@ -0,0 +1,2 @@
+import type { Candidate, CandidateOptions, TlvNode } from './types.js';
+export declare function findAsn1Candidates(node: TlvNode, options: CandidateOptions): Candidate[];

package/dist/types/core/corpus.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaCandidateTarget, SchemaCorpus, SchemaCorpusInput } from './types.js';
+export declare function createSchemaCorpus(input: SchemaCorpusInput): SchemaCorpus;
+export declare function listSchemaTargets(corpusInput: SchemaCorpusInput): SchemaCandidateTarget[];

package/dist/types/core/document.d.ts

@@ -0,0 +1,2 @@
+import type { CandidateOptions, DocumentHypothesis, TlvNode } from './types.js';
+export declare function identifyAsn1Document(node: TlvNode, options: CandidateOptions): DocumentHypothesis[];

package/dist/types/core/features.d.ts

@@ -0,0 +1,2 @@
+import type { TlvFeatures, TlvNode } from './types.js';
+export declare function extractDerFeatures(node: TlvNode): TlvFeatures;

package/dist/types/core/index.d.ts

@@ -0,0 +1,18 @@
+export { createAnnotatedTree } from './annotated-tree.js';
+export { findAsn1Candidates } from './candidates.js';
+export { createSchemaCorpus, listSchemaTargets } from './corpus.js';
+export { identifyAsn1Document } from './document.js';
+export { extractDerFeatures } from './features.js';
+export { matchType } from './matcher.js';
+export { clampScore, confidenceFromScore } from './scoring.js';
+export { describeNodeTag, getNodeTagName } from './tags.js';
+export { parseAsn1DefinitionCorpus } from '../adapters/asn1instancebuilder.js';
+export { parseInputToTlvNodes, pkistudioNodeToTlvNode } from '../adapters/pkistudiojs.js';
+export { createPkiComponentCorpus, pkiComponentDefinition } from '../corpus/pki-components.js';
+export { getPkiProfileTypeNames, pkiProfileTypeNames } from '../profiles/pki.js';
+export { createPkiCandidateReport, createPkiCandidateReportFromNodes } from '../profiles/pki-report.js';
+export { createCandidateReport, createCandidateReportFromNodes } from '../report/agent-report.js';
+export type { PkiProfileName } from '../profiles/pki.js';
+export type { PkiCandidateReportOptions } from '../profiles/pki-report.js';
+export type { AnnotatedNode, Candidate, CandidateConfidence, CandidateContext, CandidateOptions, CandidateReport, CandidateReportCandidateSummary, CandidateReportOptions, CandidateReportRoot, CandidateReportSubtree, CandidateReportSummary, Diagnostic, DiagnosticSeverity, DocumentHypothesis, EvidenceItem, MatchedPath, MatchResult, SchemaCandidateTarget, SchemaCorpus, SchemaCorpusInput, TlvFeatures, TlvNode, TlvTagClass } from './types.js';
+export type { Asn1Field, Asn1SchemaModule, Asn1Type, Asn1TypeDefinition } from './types.js';

package/dist/types/core/matcher.d.ts

@@ -0,0 +1,2 @@
+import type { Asn1SchemaModule, Asn1Type, MatchResult, TlvNode } from './types.js';
+export declare function matchType(node: TlvNode, type: Asn1Type, schema: Asn1SchemaModule, schemaPath: string, nodePath?: string): MatchResult;

package/dist/types/core/scoring.d.ts

@@ -0,0 +1,3 @@
+import type { CandidateConfidence } from './types.js';
+export declare function clampScore(score: number): number;
+export declare function confidenceFromScore(score: number): CandidateConfidence;

package/dist/types/core/tags.d.ts

@@ -0,0 +1,4 @@
+import type { TlvNode } from './types.js';
+export declare function getNodeTagName(node: TlvNode): string;
+export declare function describeNodeTag(node: TlvNode): string;
+export declare function universalTagForPrimitive(kind: string): number | undefined;

package/dist/types/core/types.d.ts

@@ -0,0 +1,153 @@
+import type { Asn1SchemaModule, Asn1TypeDefinition } from '@pkistudio/asn1instancebuilder';
+export type TlvTagClass = 'universal' | 'application' | 'context' | 'private';
+export type UniversalTagName = 'BOOLEAN' | 'INTEGER' | 'BIT STRING' | 'OCTET STRING' | 'NULL' | 'OBJECT IDENTIFIER' | 'UTF8String' | 'SEQUENCE' | 'SET' | 'PrintableString' | 'IA5String' | 'UTCTime' | 'GeneralizedTime' | string;
+export interface TlvNode {
+    id?: string;
+    tagClass: TlvTagClass;
+    tagNumber: number;
+    constructed: boolean;
+    tagName?: UniversalTagName;
+    valueBytes?: Uint8Array;
+    encodedBytes?: Uint8Array;
+    value?: unknown;
+    oid?: string;
+    oidName?: string;
+    children?: TlvNode[];
+    start?: number;
+    end?: number;
+}
+export interface TlvFeatures {
+    tagClass: TlvTagClass;
+    tagNumber: number;
+    constructed: boolean;
+    tagName: string;
+    childCount: number;
+    childTagSequence: string[];
+    oidValues: string[];
+    oidNames: string[];
+    primitiveValueKind?: string;
+    valueLength?: number;
+}
+export type CandidateConfidence = 'low' | 'medium' | 'high';
+export type DiagnosticSeverity = 'info' | 'warning' | 'error';
+export interface Diagnostic {
+    severity: DiagnosticSeverity;
+    path: string;
+    message: string;
+}
+export interface EvidenceItem {
+    path: string;
+    message: string;
+}
+export interface MatchedPath {
+    nodePath: string;
+    schemaPath: string;
+}
+export interface Candidate {
+    typeName: string;
+    moduleName?: string;
+    score: number;
+    confidence: CandidateConfidence;
+    evidence: string[];
+    diagnostics: Diagnostic[];
+    ambiguities: string[];
+    matchedPaths: MatchedPath[];
+}
+export interface CandidateOptions {
+    schemaCorpus: SchemaCorpusInput;
+    maxResults?: number;
+    minScore?: number;
+    includeTypes?: string[];
+    excludeTypes?: string[];
+    context?: CandidateContext;
+}
+export interface CandidateContext {
+    parentType?: string;
+    fieldPath?: string;
+    knownOids?: Record<string, string>;
+}
+export interface SchemaCorpus {
+    modules: Asn1SchemaModule[];
+}
+export type SchemaCorpusInput = SchemaCorpus | Asn1SchemaModule | Asn1SchemaModule[];
+export interface SchemaCandidateTarget {
+    module: Asn1SchemaModule;
+    definition: Asn1TypeDefinition;
+}
+export interface MatchResult {
+    score: number;
+    possible: boolean;
+    evidence: EvidenceItem[];
+    diagnostics: Diagnostic[];
+    ambiguities: string[];
+    matchedPaths: MatchedPath[];
+}
+export interface AnnotatedNode {
+    id?: string;
+    tagName: string;
+    asn1Type?: string;
+    fieldName?: string;
+    schemaPath?: string;
+    start?: number;
+    end?: number;
+    children: AnnotatedNode[];
+}
+export interface DocumentHypothesis {
+    rootType: string;
+    moduleName?: string;
+    score: number;
+    confidence: CandidateConfidence;
+    evidence: string[];
+    diagnostics: Diagnostic[];
+    annotatedTree: AnnotatedNode[];
+    alternatives: Candidate[];
+}
+export interface CandidateReportOptions {
+    schemaCorpus?: SchemaCorpusInput;
+    maxResults?: number;
+    minScore?: number;
+    includeTypes?: string[];
+    excludeTypes?: string[];
+    parseOptions?: Record<string, unknown>;
+    includeNodes?: boolean;
+    includeSubtrees?: boolean;
+    includeEmptySubtrees?: boolean;
+    maxSubtreeDepth?: number;
+    maxSubtreeReports?: number;
+}
+export interface CandidateReportRoot {
+    index: number;
+    node?: TlvNode;
+    features: TlvFeatures;
+    summary: CandidateReportSummary;
+    candidates: Candidate[];
+    hypotheses: DocumentHypothesis[];
+    diagnostics: Diagnostic[];
+    ambiguities: string[];
+    subtrees?: CandidateReportSubtree[];
+}
+export interface CandidateReportSubtree {
+    path: string;
+    node?: TlvNode;
+    features: TlvFeatures;
+    summary: CandidateReportSummary;
+    candidates: Candidate[];
+    diagnostics: Diagnostic[];
+    ambiguities: string[];
+}
+export interface CandidateReportSummary {
+    candidateCount: number;
+    bestCandidate?: CandidateReportCandidateSummary;
+    diagnosticCounts: Record<DiagnosticSeverity, number>;
+    ambiguityCount: number;
+}
+export interface CandidateReportCandidateSummary {
+    typeName: string;
+    moduleName?: string;
+    score: number;
+    confidence: CandidateConfidence;
+}
+export interface CandidateReport {
+    roots: CandidateReportRoot[];
+}
+export type { Asn1Field, Asn1SchemaModule, Asn1Type, Asn1TypeDefinition } from '@pkistudio/asn1instancebuilder';

package/dist/types/core.d.ts

@@ -0,0 +1 @@
+export * from './core/index.js';

package/dist/types/corpus/pki-components.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaCorpus } from '../core/types.js';
+export declare const pkiComponentDefinition = "PkiComponents DEFINITIONS EXPLICIT TAGS ::= BEGIN\nVersion ::= INTEGER { v1(0), v2(1), v3(2) }\nCertificateSerialNumber ::= INTEGER\nAlgorithmIdentifier ::= SEQUENCE {\n  algorithm OBJECT IDENTIFIER,\n  parameters CHOICE { null NULL, namedCurve OBJECT IDENTIFIER } OPTIONAL\n}\nAttributeTypeAndValue ::= SEQUENCE {\n  type OBJECT IDENTIFIER,\n  value DirectoryString\n}\nDirectoryString ::= CHOICE {\n  utf8String UTF8String,\n  printableString PrintableString,\n  ia5String IA5String\n}\nRelativeDistinguishedName ::= SET OF AttributeTypeAndValue\nRDNSequence ::= SEQUENCE OF RelativeDistinguishedName\nName ::= CHOICE {\n  rdnSequence RDNSequence\n}\nTime ::= CHOICE {\n  utcTime UTCTime,\n  generalizedTime GeneralizedTime\n}\nValidity ::= SEQUENCE {\n  notBefore Time,\n  notAfter Time\n}\nSubjectPublicKeyInfo ::= SEQUENCE {\n  algorithm AlgorithmIdentifier,\n  subjectPublicKey BIT STRING\n}\nRSAPublicKey ::= SEQUENCE {\n  modulus INTEGER,\n  publicExponent INTEGER\n}\nDSA-Sig-Value ::= SEQUENCE {\n  r INTEGER,\n  s INTEGER\n}\nECDSA-Sig-Value ::= SEQUENCE {\n  r INTEGER,\n  s INTEGER\n}\nSignatureValue ::= BIT STRING\nExtension ::= SEQUENCE {\n  extnID OBJECT IDENTIFIER,\n  critical BOOLEAN DEFAULT FALSE,\n  extnValue OCTET STRING\n}\nExtensions ::= SEQUENCE OF Extension\nTBSCertificate ::= SEQUENCE {\n  version [0] EXPLICIT Version DEFAULT v1,\n  serialNumber CertificateSerialNumber,\n  signature AlgorithmIdentifier,\n  issuer Name,\n  validity Validity,\n  subject Name,\n  subjectPublicKeyInfo SubjectPublicKeyInfo,\n  issuerUniqueID [1] IMPLICIT BIT STRING OPTIONAL,\n  subjectUniqueID [2] IMPLICIT BIT STRING OPTIONAL,\n  extensions [3] EXPLICIT Extensions OPTIONAL\n}\nCertificate ::= SEQUENCE {\n  tbsCertificate TBSCertificate,\n  signatureAlgorithm AlgorithmIdentifier,\n  signatureValue SignatureValue\n}\nCertificationRequestInfo ::= SEQUENCE {\n  version INTEGER,\n  subject Name,\n  subjectPKInfo SubjectPublicKeyInfo,\n  attributes [0] IMPLICIT SET OF AttributeTypeAndValue OPTIONAL\n}\nCertificationRequest ::= SEQUENCE {\n  certificationRequestInfo CertificationRequestInfo,\n  signatureAlgorithm AlgorithmIdentifier,\n  signature SignatureValue\n}\nPrivateKeyInfo ::= SEQUENCE {\n  version INTEGER,\n  privateKeyAlgorithm AlgorithmIdentifier,\n  privateKey OCTET STRING,\n  attributes [0] IMPLICIT SET OF AttributeTypeAndValue OPTIONAL\n}\nContentInfo ::= SEQUENCE {\n  contentType OBJECT IDENTIFIER,\n  content [0] EXPLICIT OCTET STRING OPTIONAL\n}\nEND";
+export declare function createPkiComponentCorpus(): SchemaCorpus;

package/dist/types/index.d.ts

@@ -0,0 +1 @@
+export * from './core/index.js';

package/dist/types/profiles/pki-report.d.ts

@@ -0,0 +1,8 @@
+import type { CandidateReport, CandidateReportOptions, TlvNode } from '../core/types.js';
+import { type PkiProfileName } from './pki.js';
+export interface PkiCandidateReportOptions extends Omit<CandidateReportOptions, 'schemaCorpus' | 'includeTypes'> {
+    profiles?: PkiProfileName | PkiProfileName[];
+    includeTypes?: string[];
+}
+export declare function createPkiCandidateReport(input: unknown, options?: PkiCandidateReportOptions): Promise<CandidateReport>;
+export declare function createPkiCandidateReportFromNodes(nodes: TlvNode | TlvNode[], options?: PkiCandidateReportOptions): CandidateReport;

package/dist/types/profiles/pki.d.ts

@@ -0,0 +1,3 @@
+export type PkiProfileName = 'components' | 'x509' | 'pkcs10' | 'pkcs8' | 'cms';
+export declare const pkiProfileTypeNames: Record<PkiProfileName, string[]>;
+export declare function getPkiProfileTypeNames(profiles: PkiProfileName | PkiProfileName[]): string[];

package/dist/types/report/agent-report.d.ts

@@ -0,0 +1,3 @@
+import type { CandidateReport, CandidateReportOptions, TlvNode } from '../core/types.js';
+export declare function createCandidateReport(input: unknown, options?: CandidateReportOptions): Promise<CandidateReport>;
+export declare function createCandidateReportFromNodes(nodes: TlvNode | TlvNode[], options?: CandidateReportOptions): CandidateReport;

package/dist/types/viewer.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@pkistudio/asn1defsifter",
+  "version": "0.1.0",
+  "description": "Explainable ASN.1 definition candidate resolver for DER fragments.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/types/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./app": {
+      "types": "./dist/types/app.d.ts",
+      "import": "./dist/app.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "dev": "vite --host 0.0.0.0",
+    "build": "npm run clean && npm run build:types && npm run build:lib",
+    "build:pages": "vite build -c vite.pages.config.ts",
+    "build:lib": "vite build",
+    "build:types": "tsc -p tsconfig.types.json",
+    "preview": "vite preview --host 0.0.0.0",
+    "check": "tsc --noEmit",
+    "smoke": "npm run build && node scripts/smoke.mjs",
+    "test": "vitest run",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "dependencies": {
+    "@pkistudio/asn1instancebuilder": "^0.1.2",
+    "@pkistudio/pkistudiojs": "^0.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vitest": "^3.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pkistudio/asn1defsifter"
+  },
+  "keywords": [
+    "asn1",
+    "der",
+    "pki",
+    "x509",
+    "pkistudio"
+  ],
+  "bugs": {
+    "url": "https://github.com/pkistudio/asn1defsifter/issues"
+  },
+  "homepage": "https://github.com/pkistudio/asn1defsifter#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}