@tx5dr/plugin-api 2.0.0 → 2.5.0

package/dist/toolkit/contest/FT8ContestDefinition.js

@@ -0,0 +1,167 @@
+import { oncePerBand } from './FT8ContestModules.js';
+function toIso(value, field) {
+    const date = value instanceof Date ? value : new Date(value);
+    if (!Number.isFinite(date.getTime()))
+        throw new Error(`contest_edition_invalid_${field}`);
+    return date.toISOString();
+}
+/** Defines one fixed contest occurrence; the name reflects the common weekend format. */
+export function fixedWeekendEdition(input) {
+    const startAt = toIso(input.startAt, 'start');
+    const endAt = toIso(input.endAt, 'end');
+    if (new Date(endAt).getTime() <= new Date(startAt).getTime()) {
+        throw new Error('contest_edition_invalid_range');
+    }
+    if (!input.id.trim())
+        throw new Error('contest_edition_id_required');
+    return Object.freeze({
+        id: input.id.trim(),
+        startAt,
+        endAt,
+        source: input.source ? Object.freeze({ ...input.source }) : undefined,
+    });
+}
+const SAFE_OPERATING_DEFAULTS = {
+    humanInitiation: 'required',
+    maxConcurrentQsos: 1,
+    maxSimultaneousSignals: 1,
+    cycleRelation: 'single',
+};
+const HOST_MAX_CONTEST_STREAMS = 5;
+function snapshotExchangeModule(module) {
+    return Object.freeze({
+        id: module.id,
+        decode: module.decode.bind(module),
+        encode: module.encode.bind(module),
+        validate: module.validate.bind(module),
+    });
+}
+function snapshotCompletionModule(module) {
+    return Object.freeze({ id: module.id, evaluate: module.evaluate.bind(module) });
+}
+function snapshotDupeModule(module) {
+    return Object.freeze({ id: module.id, scope: module.scope, key: module.key.bind(module) });
+}
+function snapshotScoringModule(module) {
+    return Object.freeze({
+        id: module.id,
+        score: module.score.bind(module),
+        aggregate: module.aggregate.bind(module),
+    });
+}
+function snapshotSubmissionModule(module) {
+    return Object.freeze({
+        id: module.id,
+        mediaType: module.mediaType,
+        extension: module.extension,
+        format: module.format.bind(module),
+    });
+}
+/**
+ * Composes public rule modules into a normalized FT8/FT4 contest definition.
+ * It performs no Host registration and every supplied module remains replaceable.
+ */
+export function defineFT8Contest(input) {
+    const id = input.id.trim();
+    const rulesetVersion = input.rulesetVersion.trim();
+    if (!id)
+        throw new Error('contest_id_required');
+    if (!rulesetVersion)
+        throw new Error('contest_ruleset_version_required');
+    const edition = fixedWeekendEdition(input.edition);
+    const modes = [...new Set(input.modes ?? ['FT8'])];
+    const bands = [...new Set(input.bands.map((band) => band.trim().toUpperCase()).filter(Boolean))];
+    if (modes.length === 0)
+        throw new Error('contest_modes_required');
+    if (bands.length === 0)
+        throw new Error('contest_bands_required');
+    const operating = { ...SAFE_OPERATING_DEFAULTS, ...input.operating };
+    if (!Number.isInteger(operating.maxConcurrentQsos)
+        || operating.maxConcurrentQsos < 1
+        || operating.maxConcurrentQsos > HOST_MAX_CONTEST_STREAMS) {
+        throw new Error('contest_operating_invalid_concurrent_qsos');
+    }
+    if (!Number.isInteger(operating.maxSimultaneousSignals)
+        || operating.maxSimultaneousSignals < 1
+        || operating.maxSimultaneousSignals > HOST_MAX_CONTEST_STREAMS
+        || operating.maxSimultaneousSignals > operating.maxConcurrentQsos) {
+        throw new Error('contest_operating_invalid_simultaneous_signals');
+    }
+    return Object.freeze({
+        ...input,
+        id,
+        rulesetVersion,
+        edition,
+        modes: Object.freeze(modes),
+        bands: Object.freeze(bands),
+        exchange: snapshotExchangeModule(input.exchange),
+        completion: snapshotCompletionModule(input.completion),
+        dupe: snapshotDupeModule(input.dupe ?? oncePerBand()),
+        scoring: snapshotScoringModule(input.scoring),
+        submission: snapshotSubmissionModule(input.submission),
+        operating: Object.freeze(operating),
+    });
+}
+/** Applies the common edition/mode/band/status/dupe envelope once for score and export. */
+export function projectFT8ContestQsos(contest, records) {
+    const start = Date.parse(contest.edition.startAt);
+    const end = Date.parse(contest.edition.endAt);
+    const modes = new Set(contest.modes);
+    const bands = new Set(contest.bands.map((band) => band.toUpperCase()));
+    const worked = new Set();
+    return records
+        .map((qso, index) => ({ qso, index }))
+        .sort((left, right) => left.qso.startTime - right.qso.startTime || left.index - right.index)
+        .map(({ qso }) => {
+        const issues = [];
+        const band = qso.band.trim().toUpperCase();
+        const baseEligible = Number.isFinite(qso.startTime)
+            && qso.startTime >= start
+            && qso.startTime < end
+            && modes.has(qso.mode)
+            && bands.has(band);
+        if (!Number.isFinite(qso.startTime) || qso.startTime < start || qso.startTime >= end) {
+            issues.push('outside_edition');
+        }
+        if (!modes.has(qso.mode))
+            issues.push('unsupported_mode');
+        if (!bands.has(band))
+            issues.push('unsupported_band');
+        const status = qso.status ?? 'included';
+        if (status === 'review')
+            issues.push('review');
+        if (status === 'excluded')
+            issues.push('excluded');
+        if (status === 'x-qso')
+            issues.push('x_qso');
+        const key = contest.dupe.key(qso);
+        const countsAsWorked = baseEligible && (status === 'included' || status === 'review');
+        const dupe = countsAsWorked && worked.has(key);
+        if (dupe)
+            issues.push('dupe');
+        if (countsAsWorked)
+            worked.add(key);
+        const scoreEligible = baseEligible && status === 'included' && !dupe;
+        return {
+            qso,
+            dupe,
+            issues,
+            eligible: scoreEligible,
+            scoreEligible,
+            submissionEligible: baseEligible && (status === 'included' || status === 'x-qso'),
+        };
+    });
+}
+export function scoreFT8ContestQsos(contest, records) {
+    const scores = projectFT8ContestQsos(contest, records)
+        .filter((row) => row.scoreEligible)
+        .map((row) => contest.scoring.score(row.qso));
+    return contest.scoring.aggregate(scores);
+}
+export function formatFT8ContestSubmission(contest, records, options) {
+    const eligible = projectFT8ContestQsos(contest, records)
+        .filter((row) => row.submissionEligible)
+        .map((row) => row.qso);
+    return contest.submission.format(eligible, options);
+}
+//# sourceMappingURL=FT8ContestDefinition.js.map

package/dist/toolkit/contest/FT8ContestDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestDefinition.js","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestDefinition.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/contest/FT8ContestModules.d.ts

@@ -0,0 +1,178 @@
+import { type CabrilloDocumentInput } from './CabrilloBuilder.js';
+/** Modes currently covered by the FT8 contest composition API. */
+export type FT8ContestMode = 'FT8' | 'FT4';
+/** Flat exchange fields suitable for a contest QSO envelope or submission adapter. */
+export type ContestExchangeFields = Readonly<Record<string, string>>;
+export interface ContestValidationIssue {
+    code: string;
+    field?: string;
+    message?: string;
+}
+export type FT8ExchangeDecodeResult<TExchange> = {
+    ok: true;
+    value: TExchange;
+} | {
+    ok: false;
+    issues: readonly ContestValidationIssue[];
+};
+/** Converts between typed contest exchange data and flat persisted fields. */
+export interface FT8ExchangeModule<TExchange> {
+    readonly id: string;
+    decode(fields: ContestExchangeFields): FT8ExchangeDecodeResult<TExchange>;
+    encode(exchange: TExchange): ContestExchangeFields;
+    validate(exchange: TExchange): readonly ContestValidationIssue[];
+}
+export declare function defineFT8ExchangeModule<TExchange>(module: FT8ExchangeModule<TExchange>): FT8ExchangeModule<TExchange>;
+export interface GridExchange {
+    grid: string;
+}
+export interface GridAndSnrExchange extends GridExchange {
+    snr: number;
+}
+export interface GridExchangeOptions {
+    /** Value used when an imported exchange has no grid. Omit to reject it. */
+    missingGrid?: string;
+}
+/** Common four-character Maidenhead exchange. */
+export declare function gridExchange(options?: GridExchangeOptions): FT8ExchangeModule<GridExchange>;
+/** Four-character Maidenhead plus an integer signal report. */
+export declare function gridAndSnrExchange(options?: GridExchangeOptions): FT8ExchangeModule<GridAndSnrExchange>;
+export interface CompletionEvidence<TExchange> {
+    sentExchange?: TExchange;
+    receivedExchange?: TExchange;
+    sentFinalAck?: boolean;
+    receivedFinalAck?: boolean;
+}
+export interface CompletionEvaluation {
+    complete: boolean;
+    missing: readonly string[];
+}
+/** Pure completion policy. It never keys the radio or mutates Host state. */
+export interface CompletionModule<TExchange> {
+    readonly id: string;
+    evaluate(evidence: CompletionEvidence<TExchange>): CompletionEvaluation;
+}
+export declare function defineCompletionModule<TExchange>(module: CompletionModule<TExchange>): CompletionModule<TExchange>;
+export interface ExchangeAndFinalAckOptions {
+    exchange?: 'received' | 'both';
+    finalAck?: 'sent' | 'received' | 'either' | 'both';
+}
+/** Requires exchange evidence and an explicit final acknowledgement. */
+export declare function requireExchangeAndFinalAck<TExchange>(options?: ExchangeAndFinalAckOptions): CompletionModule<TExchange>;
+/** Minimal QSO shape used by common FT8 contest modules. Plugins may extend it. */
+export interface FT8ContestQso<TExchange = unknown> {
+    callsign: string;
+    band: string;
+    mode: FT8ContestMode;
+    /** QSO start time used for edition eligibility. */
+    startTime: number;
+    /** Review/excluded records remain visible but are not scored or submitted. */
+    status?: 'included' | 'review' | 'excluded' | 'x-qso';
+    sentExchange?: TExchange;
+    receivedExchange?: TExchange;
+    distanceKm?: number;
+}
+/** Center-to-center Maidenhead distance shared by FT8 distance-scoring rules. */
+export declare function maidenheadDistanceKm(fromGrid: string, toGrid: string): number | undefined;
+export interface ContestSerialOptions<TRecord> {
+    serial(record: TRecord): string | number | undefined;
+    startAt?: number;
+    width?: number;
+}
+/**
+ * Allocates the next serial from a current QSO snapshot. Call this inside
+ * `ContestApplicationSessionFacade.transact()` so revision retries re-plan it.
+ */
+export declare function nextContestSerial<TRecord>(records: readonly TRecord[], options: ContestSerialOptions<TRecord>): string;
+export type DupeScope = 'band' | 'mode' | 'session' | 'contest';
+export interface DupeModule<TQso> {
+    readonly id: string;
+    readonly scope: DupeScope;
+    key(qso: TQso): string;
+}
+export declare function defineDupeModule<TQso>(module: DupeModule<TQso>): DupeModule<TQso>;
+export interface OncePerBandOptions {
+    /** Set true only when FT4 and FT8 are separate duplicate scopes. */
+    includeMode?: boolean;
+}
+/** Default FT contest duplicate policy: normalized callsign once per band. */
+export declare function oncePerBand<TQso extends Pick<FT8ContestQso, 'callsign' | 'band' | 'mode'>>(options?: OncePerBandOptions): DupeModule<TQso>;
+export interface ContestQsoScore {
+    points: number;
+    multiplierKeys: readonly string[];
+    eligible: boolean;
+}
+export interface ContestScoreSummary {
+    qsoCount: number;
+    qsoPoints: number;
+    multiplierCount: number;
+    total: number;
+}
+export interface ScoringModule<TQso> {
+    readonly id: string;
+    score(qso: TQso): ContestQsoScore;
+    aggregate(scores: readonly ContestQsoScore[]): ContestScoreSummary;
+}
+export declare function defineScoringModule<TQso>(module: ScoringModule<TQso>): ScoringModule<TQso>;
+export interface ScoreByOptions<TQso> {
+    id: string;
+    points(qso: TQso): number;
+    eligible?(qso: TQso, points: number): boolean;
+    multiplierKeys?(qso: TQso): readonly string[];
+    aggregate?(scores: readonly ContestQsoScore[]): ContestScoreSummary;
+}
+/**
+ * Builds a scoring module from a point function and optional multiplier key extractor.
+ * Use this for contest families whose score is not covered by the canned distance helper.
+ */
+export declare function scoreBy<TQso>(options: ScoreByOptions<TQso>): ScoringModule<TQso>;
+export interface FixedPointsOptions<TQso> {
+    eligible?(qso: TQso): boolean;
+    multiplierKeys?(qso: TQso): readonly string[];
+}
+/** Convenience wrapper for contests that award a fixed number of points per QSO. */
+export declare function fixedPoints<TQso>(points: number, options?: FixedPointsOptions<TQso>): ScoringModule<TQso>;
+export interface DistancePointsOptions<TQso> {
+    stepKm: number;
+    rounding?: 'floor' | 'ceil';
+    basePoints?: number;
+    /** Minimum number of distance steps, used by rules that award one step for any valid QSO. */
+    minimumDistanceSteps?: number;
+    missingDistancePoints?: number;
+    distanceKm?: (qso: TQso) => number | undefined;
+    multiplierKeys?: (qso: TQso) => readonly string[];
+}
+/** Common distance-step scoring with optional multiplier aggregation. */
+export declare function distancePoints<TQso extends {
+    distanceKm?: number;
+} = FT8ContestQso>(options: DistancePointsOptions<TQso>): ScoringModule<TQso>;
+export interface MultiplierKeysFromOptions<TQso> {
+    key(qso: TQso): string | undefined;
+    band?: (qso: TQso) => string | undefined;
+    normalize?(key: string): string;
+}
+/**
+ * Builds multiplier keys from one normalized field. Scope the key by band when
+ * the contest counts per-band multipliers; omit band to count once per contest.
+ */
+export declare function multiplierKeysFrom<TQso>(options: MultiplierKeysFromOptions<TQso>): (qso: TQso) => readonly string[];
+export interface GridFieldMultiplierOptions<TQso> {
+    grid(qso: TQso): string | undefined;
+    band?: (qso: TQso) => string | undefined;
+}
+/** Builds multiplier keys from the first two characters of a valid grid. */
+export declare function gridFieldMultiplier<TQso>(options: GridFieldMultiplierOptions<TQso>): (qso: TQso) => readonly string[];
+export interface SubmissionModule<TQso, TOptions = void> {
+    readonly id: string;
+    readonly mediaType: string;
+    readonly extension: string;
+    format(records: readonly TQso[], options: TOptions): string;
+}
+export declare function defineSubmissionModule<TQso, TOptions = void>(module: SubmissionModule<TQso, TOptions>): SubmissionModule<TQso, TOptions>;
+export interface CabrilloSubmissionOptions<TQso, TOptions> {
+    headers(options: TOptions): CabrilloDocumentInput['headers'];
+    qsoLine(qso: TQso, options: TOptions): string;
+}
+/** Cabrillo adapter that leaves every contest-specific column with the plugin. */
+export declare function cabrilloSubmission<TQso = FT8ContestQso, TOptions = void>(options: CabrilloSubmissionOptions<TQso, TOptions>): SubmissionModule<TQso, TOptions>;
+//# sourceMappingURL=FT8ContestModules.d.ts.map

package/dist/toolkit/contest/FT8ContestModules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestModules.d.ts","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestModules.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/contest/FT8ContestModules.js

@@ -0,0 +1,247 @@
+import { normalizeCallsign } from '../../utils/callsign.js';
+import { calculateGridDistance } from '@tx5dr/core';
+import { buildCabrilloDocument } from './CabrilloBuilder.js';
+export function defineFT8ExchangeModule(module) {
+    return module;
+}
+function normalizeGrid(grid) {
+    return grid.trim().toUpperCase();
+}
+function validateGrid(grid, allowedMissingGrid) {
+    const normalized = normalizeGrid(grid);
+    if (allowedMissingGrid && normalized === normalizeGrid(allowedMissingGrid))
+        return [];
+    if (!/^[A-R]{2}[0-9]{2}$/.test(normalized)) {
+        return [{ code: 'invalid_grid', field: 'grid' }];
+    }
+    return [];
+}
+/** Common four-character Maidenhead exchange. */
+export function gridExchange(options = {}) {
+    return defineFT8ExchangeModule({
+        id: 'grid-4',
+        decode(fields) {
+            const grid = normalizeGrid(fields.grid ?? options.missingGrid ?? '');
+            const issues = validateGrid(grid, options.missingGrid);
+            return issues.length > 0 ? { ok: false, issues } : { ok: true, value: { grid } };
+        },
+        encode(exchange) {
+            return { grid: normalizeGrid(exchange.grid) };
+        },
+        validate(exchange) {
+            return validateGrid(exchange.grid, options.missingGrid);
+        },
+    });
+}
+/** Four-character Maidenhead plus an integer signal report. */
+export function gridAndSnrExchange(options = {}) {
+    return defineFT8ExchangeModule({
+        id: 'grid-4-and-snr',
+        decode(fields) {
+            const grid = normalizeGrid(fields.grid ?? options.missingGrid ?? '');
+            const snrText = fields.snr?.trim() ?? '';
+            const snr = Number(snrText);
+            const issues = validateGrid(grid, options.missingGrid);
+            if (snrText === '' || !Number.isInteger(snr)) {
+                issues.push({ code: 'invalid_snr', field: 'snr' });
+            }
+            return issues.length > 0 ? { ok: false, issues } : { ok: true, value: { grid, snr } };
+        },
+        encode(exchange) {
+            return { grid: normalizeGrid(exchange.grid), snr: String(exchange.snr) };
+        },
+        validate(exchange) {
+            const issues = validateGrid(exchange.grid, options.missingGrid);
+            if (!Number.isInteger(exchange.snr))
+                issues.push({ code: 'invalid_snr', field: 'snr' });
+            return issues;
+        },
+    });
+}
+export function defineCompletionModule(module) {
+    return module;
+}
+/** Requires exchange evidence and an explicit final acknowledgement. */
+export function requireExchangeAndFinalAck(options = {}) {
+    const exchange = options.exchange ?? 'both';
+    const finalAck = options.finalAck ?? 'either';
+    return {
+        id: `exchange-${exchange}-final-ack-${finalAck}`,
+        evaluate(evidence) {
+            const missing = [];
+            if (!evidence.receivedExchange)
+                missing.push('received_exchange');
+            if (exchange === 'both' && !evidence.sentExchange)
+                missing.push('sent_exchange');
+            if (finalAck === 'sent' && !evidence.sentFinalAck)
+                missing.push('sent_final_ack');
+            if (finalAck === 'received' && !evidence.receivedFinalAck)
+                missing.push('received_final_ack');
+            if (finalAck === 'either' && !evidence.sentFinalAck && !evidence.receivedFinalAck) {
+                missing.push('final_ack');
+            }
+            if (finalAck === 'both') {
+                if (!evidence.sentFinalAck)
+                    missing.push('sent_final_ack');
+                if (!evidence.receivedFinalAck)
+                    missing.push('received_final_ack');
+            }
+            return { complete: missing.length === 0, missing };
+        },
+    };
+}
+/** Center-to-center Maidenhead distance shared by FT8 distance-scoring rules. */
+export function maidenheadDistanceKm(fromGrid, toGrid) {
+    return calculateGridDistance(fromGrid, toGrid) ?? undefined;
+}
+/**
+ * Allocates the next serial from a current QSO snapshot. Call this inside
+ * `ContestApplicationSessionFacade.transact()` so revision retries re-plan it.
+ */
+export function nextContestSerial(records, options) {
+    const startAt = options.startAt ?? 1;
+    const width = options.width ?? 3;
+    if (!Number.isInteger(startAt) || startAt < 1 || !Number.isInteger(width) || width < 1 || width > 9) {
+        throw new Error('contest_serial_invalid_options');
+    }
+    let maximum = startAt - 1;
+    for (const record of records) {
+        const value = options.serial(record);
+        const text = typeof value === 'number' ? String(value) : value?.trim();
+        if (!text || !/^\d+$/.test(text))
+            continue;
+        const serial = Number(text);
+        if (Number.isSafeInteger(serial) && serial >= startAt)
+            maximum = Math.max(maximum, serial);
+    }
+    return String(maximum + 1).padStart(width, '0');
+}
+export function defineDupeModule(module) {
+    return module;
+}
+/** Default FT contest duplicate policy: normalized callsign once per band. */
+export function oncePerBand(options = {}) {
+    return defineDupeModule({
+        id: options.includeMode ? 'callsign-band-mode' : 'callsign-band',
+        scope: options.includeMode ? 'mode' : 'band',
+        key(qso) {
+            const parts = [normalizeCallsign(qso.callsign), qso.band.trim().toUpperCase()];
+            if (options.includeMode)
+                parts.push(qso.mode);
+            return parts.join(':');
+        },
+    });
+}
+export function defineScoringModule(module) {
+    return module;
+}
+function aggregateContestScores(scores) {
+    const eligible = scores.filter((score) => score.eligible);
+    const qsoPoints = eligible.reduce((sum, score) => sum + score.points, 0);
+    const multiplierCount = new Set(eligible.flatMap((score) => score.multiplierKeys)).size;
+    return {
+        qsoCount: eligible.length,
+        qsoPoints,
+        multiplierCount,
+        total: multiplierCount > 0 ? qsoPoints * multiplierCount : qsoPoints,
+    };
+}
+/**
+ * Builds a scoring module from a point function and optional multiplier key extractor.
+ * Use this for contest families whose score is not covered by the canned distance helper.
+ */
+export function scoreBy(options) {
+    const aggregate = options.aggregate ?? aggregateContestScores;
+    return defineScoringModule({
+        id: options.id.trim(),
+        score(qso) {
+            const points = options.points(qso);
+            return {
+                points,
+                multiplierKeys: options.multiplierKeys?.(qso) ?? [],
+                eligible: options.eligible?.(qso, points) ?? points > 0,
+            };
+        },
+        aggregate,
+    });
+}
+/** Convenience wrapper for contests that award a fixed number of points per QSO. */
+export function fixedPoints(points, options = {}) {
+    if (!Number.isFinite(points))
+        throw new Error('contest_scoring_invalid_points');
+    return scoreBy({
+        id: `fixed-${points}`,
+        points: () => points,
+        eligible: options.eligible ?? (() => true),
+        multiplierKeys: options.multiplierKeys,
+    });
+}
+/** Common distance-step scoring with optional multiplier aggregation. */
+export function distancePoints(options) {
+    if (!Number.isFinite(options.stepKm) || options.stepKm <= 0) {
+        throw new Error('contest_scoring_invalid_step_km');
+    }
+    const basePoints = options.basePoints ?? 1;
+    const minimumDistanceSteps = options.minimumDistanceSteps ?? 0;
+    if (!Number.isInteger(minimumDistanceSteps) || minimumDistanceSteps < 0) {
+        throw new Error('contest_scoring_invalid_minimum_distance_steps');
+    }
+    const rounding = options.rounding ?? 'floor';
+    const round = rounding === 'ceil' ? Math.ceil : Math.floor;
+    return scoreBy({
+        id: `distance-${rounding}-${options.stepKm}`,
+        points(qso) {
+            const distanceKm = options.distanceKm?.(qso) ?? qso.distanceKm;
+            return distanceKm === undefined || !Number.isFinite(distanceKm) || distanceKm < 0
+                ? options.missingDistancePoints ?? 0
+                : basePoints + Math.max(minimumDistanceSteps, round(distanceKm / options.stepKm));
+        },
+        eligible(_qso, points) {
+            return points > 0;
+        },
+        multiplierKeys: options.multiplierKeys,
+    });
+}
+/**
+ * Builds multiplier keys from one normalized field. Scope the key by band when
+ * the contest counts per-band multipliers; omit band to count once per contest.
+ */
+export function multiplierKeysFrom(options) {
+    return (qso) => {
+        const raw = options.key(qso)?.trim();
+        if (!raw)
+            return [];
+        const key = (options.normalize ?? ((value) => value.toUpperCase()))(raw);
+        const band = options.band?.(qso)?.trim().toUpperCase();
+        return [band ? `${band}:${key}` : key];
+    };
+}
+/** Builds multiplier keys from the first two characters of a valid grid. */
+export function gridFieldMultiplier(options) {
+    return multiplierKeysFrom({
+        key(qso) {
+            const grid = normalizeGrid(options.grid(qso) ?? '');
+            return /^[A-R]{2}[0-9]{2}$/.test(grid) ? grid.slice(0, 2) : undefined;
+        },
+        band: options.band,
+        normalize: (value) => value.toUpperCase(),
+    });
+}
+export function defineSubmissionModule(module) {
+    return module;
+}
+/** Cabrillo adapter that leaves every contest-specific column with the plugin. */
+export function cabrilloSubmission(options) {
+    return defineSubmissionModule({
+        id: 'cabrillo-3',
+        mediaType: 'text/plain',
+        extension: '.log',
+        format(records, formatOptions) {
+            return buildCabrilloDocument({
+                headers: options.headers(formatOptions),
+                qsoLines: records.map((record) => options.qsoLine(record, formatOptions)),
+            });
+        },
+    });
+}
+//# sourceMappingURL=FT8ContestModules.js.map

package/dist/toolkit/contest/FT8ContestModules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FT8ContestModules.js","sourceRoot":"","sources":["../../../src/toolkit/contest/FT8ContestModules.ts"],"names":[],"mappings":"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"}