openplanter 0.1.0

package/dist/investigation-tools/asic-officer-lookup.js

@@ -0,0 +1,197 @@
+/**
+ * asic-officer-lookup.ts – Query ASIC company officer/director data by ABN or
+ * ASX ticker.
+ *
+ * Data sources:
+ *   - ASIC Connect Registry Search:
+ *     https://connectonline.asic.gov.au/RegistrySearch/faces/landing/SearchRegisters.jspx
+ *   - Australian Business Register (ABR) JSON API:
+ *     https://abr.business.gov.au/json/AbnDetails.aspx?abn=XXX&callback=callback
+ *   - ASX Company Info API:
+ *     https://www.asx.com.au/asx/1/company/{ticker}
+ */
+import { fetchHtml, fetchWithDelay, fetchJson, cleanAbn, formatAbn, sleep, } from "./shared.js";
+// ── Constants ────────────────────────────────────────────────────
+const ASIC_SEARCH_URL = "https://connectonline.asic.gov.au/RegistrySearch/faces/landing/" +
+    "SearchRegisters.jspx";
+const ABR_API_URL = "https://abr.business.gov.au/json/AbnDetails.aspx";
+const ASX_COMPANY_URL = "https://www.asx.com.au/asx/1/company/{ticker}";
+const DEFAULT_MAX_RESULTS = 20;
+const DEFAULT_DELAY = 1.0;
+// ── Helpers ──────────────────────────────────────────────────────
+function isAbnInput(value) {
+    const digits = value.replace(/\D/g, "");
+    return digits.length === 11;
+}
+// ── ASX company info lookup ──────────────────────────────────────
+export async function resolveTicker(ticker, delay = DEFAULT_DELAY) {
+    const url = ASX_COMPANY_URL.replace("{ticker}", ticker.toUpperCase());
+    try {
+        return await fetchJson(url, { delay });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[WARN] ASX company lookup failed for ${ticker}: ${msg}`);
+        return null;
+    }
+}
+// ── ABR API lookup ───────────────────────────────────────────────
+export async function queryAbr(abn, delay = DEFAULT_DELAY) {
+    const clean = cleanAbn(abn);
+    const url = `${ABR_API_URL}?abn=${clean}&callback=callback`;
+    try {
+        const resp = await fetchWithDelay(url, { delay });
+        if (!resp.ok) {
+            throw new Error(`HTTP ${resp.status}`);
+        }
+        const text = (await resp.text()).trim();
+        // Strip JSONP wrapper: callback({...})
+        const match = text.match(/^callback\((.+)\)\s*$/s);
+        if (match) {
+            return JSON.parse(match[1]);
+        }
+        return null;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[WARN] ABR lookup failed for ABN ${clean}: ${msg}`);
+        return null;
+    }
+}
+// ── ASIC Connect scraping (best-effort) ──────────────────────────
+export async function queryAsic(_searchTerm, delay = DEFAULT_DELAY) {
+    const officers = [];
+    try {
+        // Step 1: GET the landing page to obtain ViewState
+        const ch = await fetchHtml(ASIC_SEARCH_URL, { delay });
+        const viewstateTag = ch('input[name="javax.faces.ViewState"]');
+        if (!viewstateTag.length) {
+            console.error("[WARN] ASIC Connect: could not locate ViewState – falling back to ABR.");
+            return officers;
+        }
+        const viewstate = viewstateTag.attr("value") ?? "";
+        // Step 2: POST a search form submission
+        // ASIC Connect form IDs change frequently; this is best-effort.
+        const formData = new URLSearchParams({
+            "javax.faces.ViewState": viewstate,
+            "javax.faces.partial.ajax": "true",
+        });
+        await sleep(delay * 1000);
+        const searchResp = await fetch(ASIC_SEARCH_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: formData.toString(),
+        });
+        if (!searchResp.ok) {
+            throw new Error(`HTTP ${searchResp.status}`);
+        }
+        // Step 3: Parse officer table from results
+        const cheerio = await import("cheerio");
+        const resultHtml = await searchResp.text();
+        const result$ = cheerio.load(resultHtml);
+        const rows = result$("table.officer-table tr").toArray();
+        for (const row of rows) {
+            const cells = result$(row).find("td");
+            if (cells.length >= 3) {
+                officers.push({
+                    company_name: null,
+                    abn: null,
+                    ticker: null,
+                    officer_name: cells.eq(0).text().trim(),
+                    role: cells.eq(1).text().trim(),
+                    appointment_date: cells.eq(2).text().trim() || null,
+                    cessation_date: cells.length > 3
+                        ? cells.eq(3).text().trim() || null
+                        : null,
+                });
+            }
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[WARN] ASIC Connect scraping failed: ${msg}`);
+    }
+    return officers;
+}
+// ── Composite lookup ─────────────────────────────────────────────
+export async function lookupOfficers(abnOrTicker, maxResults = DEFAULT_MAX_RESULTS) {
+    const results = [];
+    let companyName = null;
+    let abn = null;
+    let ticker = null;
+    // Determine whether input is ABN or ticker
+    if (isAbnInput(abnOrTicker)) {
+        abn = cleanAbn(abnOrTicker);
+    }
+    else {
+        ticker = abnOrTicker.toUpperCase().trim();
+    }
+    // Resolve ticker via ASX
+    if (ticker) {
+        const asxInfo = await resolveTicker(ticker);
+        if (asxInfo) {
+            companyName = asxInfo.name_full ?? asxInfo.name_short ?? null;
+            console.error(`[INFO] ASX resolved ${ticker} → ${companyName}`);
+        }
+        await sleep(DEFAULT_DELAY * 1000);
+    }
+    // Query ABR for ABN details
+    if (abn) {
+        const abrData = await queryAbr(abn);
+        if (abrData) {
+            const entityName = abrData.EntityName ?? "";
+            const businessNames = abrData.BusinessName ?? [];
+            if (entityName) {
+                companyName = companyName ?? entityName;
+            }
+            if (Array.isArray(businessNames) && businessNames.length > 0) {
+                const firstBn = businessNames[0];
+                if (typeof firstBn === "string") {
+                    companyName = companyName ?? firstBn;
+                }
+                else if (typeof firstBn === "object" && firstBn !== null) {
+                    companyName =
+                        companyName ?? firstBn.Value ?? null;
+                }
+            }
+            const abnValue = abrData.Abn ?? abn;
+            abn = cleanAbn(String(abnValue));
+            console.error(`[INFO] ABR resolved ABN ${formatAbn(abn)} → ${companyName}`);
+        }
+        await sleep(DEFAULT_DELAY * 1000);
+    }
+    // Attempt ASIC Connect scraping
+    const searchTerm = abn ?? ticker ?? abnOrTicker;
+    const asicOfficers = await queryAsic(searchTerm);
+    if (asicOfficers.length > 0) {
+        for (const off of asicOfficers.slice(0, maxResults)) {
+            results.push({
+                company_name: companyName,
+                abn: abn ? formatAbn(abn) : null,
+                ticker,
+                officer_name: off.officer_name,
+                role: off.role,
+                appointment_date: off.appointment_date,
+                cessation_date: off.cessation_date,
+            });
+        }
+    }
+    else {
+        // ASIC scraping failed – return a stub record with company metadata
+        console.error("[INFO] ASIC officer scraping returned no results; returning " +
+            "company-level metadata only.");
+        results.push({
+            company_name: companyName,
+            abn: abn ? formatAbn(abn) : null,
+            ticker,
+            officer_name: null,
+            role: null,
+            appointment_date: null,
+            cessation_date: null,
+            _note: "ASIC Connect scraping did not return officer details. " +
+                "Manual lookup may be required.",
+        });
+    }
+    return results.slice(0, maxResults);
+}
+//# sourceMappingURL=asic-officer-lookup.js.map

package/dist/investigation-tools/asic-officer-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asic-officer-lookup.js","sourceRoot":"","sources":["../../src/investigation-tools/asic-officer-lookup.ts"],"names":[],"mappings":"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"}

package/dist/investigation-tools/asx-calendar-fetcher.d.ts

@@ -0,0 +1,42 @@
+/**
+ * asx-calendar-fetcher.ts — ASX Appendix 4C Reporting Calendar Fetcher
+ *
+ * Scrapes scheduled ASX Appendix 4C (quarterly cashflow) due dates from
+ * Listcorp and outputs structured data for downstream analysis.
+ */
+declare const OUTPUT_COLUMNS: readonly ["ticker", "company_name", "quarter_end", "due_date", "lodged_date", "status"];
+export interface CalendarEntry {
+    ticker: string;
+    company_name: string;
+    quarter_end: string;
+    due_date: string;
+    lodged_date: string | null;
+    status: "upcoming" | "overdue" | "lodged";
+}
+export interface PeriodRange {
+    start: Date;
+    end: Date;
+}
+/**
+ * Parse a period string into a date range for filtering.
+ *
+ * Supported formats:
+ *   - next_30d, next_90d, next_NNd — from today through NN days ahead
+ *   - Q1_2026, Q2_2026, etc. — quarter due date window
+ */
+export declare function parsePeriod(period: string): PeriodRange;
+export declare function fetchCalendarLive(): Promise<CalendarEntry[]>;
+/**
+ * Fetch and filter ASX 4C calendar entries.
+ *
+ * @param options.tickers - Comma-separated tickers or "all"
+ * @param options.period - Period string (next_30d, Q1_2026, etc.)
+ * @param options.records - Pre-fetched records (for testing / offline use)
+ */
+export declare function fetchCalendar(options?: {
+    tickers?: string;
+    period?: string;
+    records?: CalendarEntry[];
+}): Promise<CalendarEntry[]>;
+export { OUTPUT_COLUMNS };
+//# sourceMappingURL=asx-calendar-fetcher.d.ts.map

package/dist/investigation-tools/asx-calendar-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asx-calendar-fetcher.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/asx-calendar-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,QAAA,MAAM,cAAc,yFAOV,CAAC;AAkDX,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAwCvD;AAwJD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CASlE;AAID;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAgC3B;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/investigation-tools/asx-calendar-fetcher.js

@@ -0,0 +1,271 @@
+/**
+ * asx-calendar-fetcher.ts — ASX Appendix 4C Reporting Calendar Fetcher
+ *
+ * Scrapes scheduled ASX Appendix 4C (quarterly cashflow) due dates from
+ * Listcorp and outputs structured data for downstream analysis.
+ */
+import { fetchHtml, normalizeTicker } from "./shared.js";
+// ── Constants ────────────────────────────────────────────────────
+const LISTCORP_UPCOMING_URL = "https://www.listcorp.com/asx/upcoming-reports";
+const OUTPUT_COLUMNS = [
+    "ticker",
+    "company_name",
+    "quarter_end",
+    "due_date",
+    "lodged_date",
+    "status",
+];
+/** Quarter-end month mappings (calendar quarters) */
+const QUARTER_END_MONTHS = {
+    Q1: 3,
+    Q2: 6,
+    Q3: 9,
+    Q4: 12,
+};
+const QUARTER_END_DAYS = {
+    Q1: 31,
+    Q2: 30,
+    Q3: 30,
+    Q4: 31,
+};
+/** 4C reports are due within ~1 month after quarter end */
+const REPORT_DUE_OFFSET_DAYS = 31;
+/** Date formats for parsing cell text */
+const DATE_FORMATS = [
+    {
+        // DD/MM/YYYY
+        regex: /^(\d{1,2})\/(\d{1,2})\/(\d{4})$/,
+        parse: (m) => new Date(+m[3], +m[2] - 1, +m[1]),
+    },
+    {
+        // YYYY-MM-DD
+        regex: /^(\d{4})-(\d{2})-(\d{2})$/,
+        parse: (m) => new Date(+m[1], +m[2] - 1, +m[3]),
+    },
+    {
+        // DD-MM-YYYY
+        regex: /^(\d{1,2})-(\d{1,2})-(\d{4})$/,
+        parse: (m) => new Date(+m[3], +m[2] - 1, +m[1]),
+    },
+    {
+        // DD Mon YYYY (e.g. "15 Feb 2026")
+        regex: /^(\d{1,2})\s+(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)\s+(\d{4})$/i,
+        parse: (m) => new Date(`${m[2]} ${m[1]}, ${m[3]}`),
+    },
+];
+// ── Period Parsing ───────────────────────────────────────────────
+/**
+ * Parse a period string into a date range for filtering.
+ *
+ * Supported formats:
+ *   - next_30d, next_90d, next_NNd — from today through NN days ahead
+ *   - Q1_2026, Q2_2026, etc. — quarter due date window
+ */
+export function parsePeriod(period) {
+    const trimmed = period.trim();
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+    // Handle next_Nd pattern
+    if (trimmed.startsWith("next_") && trimmed.endsWith("d")) {
+        const daysStr = trimmed.slice(5, -1);
+        const days = parseInt(daysStr, 10);
+        if (isNaN(days)) {
+            throw new Error(`Invalid period '${period}'. Expected format: next_30d`);
+        }
+        const end = new Date(today);
+        end.setDate(end.getDate() + days);
+        return { start: today, end };
+    }
+    // Handle QN_YYYY pattern
+    if (trimmed.includes("_")) {
+        const parts = trimmed.split("_", 2);
+        const quarterKey = parts[0].toUpperCase();
+        if (quarterKey in QUARTER_END_MONTHS && parts.length === 2) {
+            const year = parseInt(parts[1], 10);
+            if (isNaN(year)) {
+                throw new Error(`Invalid year in period '${period}'.`);
+            }
+            const month = QUARTER_END_MONTHS[quarterKey];
+            const day = QUARTER_END_DAYS[quarterKey];
+            const quarterEnd = new Date(year, month - 1, day);
+            const dueEnd = new Date(quarterEnd);
+            dueEnd.setDate(dueEnd.getDate() + REPORT_DUE_OFFSET_DAYS);
+            return { start: quarterEnd, end: dueEnd };
+        }
+    }
+    throw new Error(`Unrecognised period '${period}'. Use next_30d, next_90d, Q1_2026, Q2_2026, etc.`);
+}
+// ── Helpers ──────────────────────────────────────────────────────
+function inferQuarterEnd(dueDate) {
+    const approxQtrEnd = new Date(dueDate);
+    approxQtrEnd.setDate(approxQtrEnd.getDate() - REPORT_DUE_OFFSET_DAYS);
+    const month = approxQtrEnd.getMonth() + 1; // 1-based
+    if (month <= 3) {
+        return `${approxQtrEnd.getFullYear()}-03-31`;
+    }
+    else if (month <= 6) {
+        return `${approxQtrEnd.getFullYear()}-06-30`;
+    }
+    else if (month <= 9) {
+        return `${approxQtrEnd.getFullYear()}-09-30`;
+    }
+    else {
+        return `${approxQtrEnd.getFullYear()}-12-31`;
+    }
+}
+function tryParseDate(text) {
+    const trimmed = text.trim();
+    for (const fmt of DATE_FORMATS) {
+        const m = trimmed.match(fmt.regex);
+        if (m) {
+            const d = fmt.parse(m);
+            if (!isNaN(d.getTime()))
+                return d;
+        }
+    }
+    return null;
+}
+function formatDateIso(d) {
+    const year = d.getFullYear();
+    const month = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+function determineStatus(dueDateStr, lodgedDateStr) {
+    if (lodgedDateStr)
+        return "lodged";
+    const dueDt = new Date(dueDateStr);
+    if (isNaN(dueDt.getTime()))
+        return "upcoming";
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+    return dueDt < today ? "overdue" : "upcoming";
+}
+function filterByTickers(records, tickers) {
+    const tickerSet = new Set(tickers.map((t) => normalizeTicker(t)));
+    return records.filter((r) => tickerSet.has(r.ticker));
+}
+function filterByPeriod(records, startDate, endDate) {
+    return records.filter((rec) => {
+        if (!rec.due_date)
+            return false;
+        const dueDt = new Date(rec.due_date);
+        if (isNaN(dueDt.getTime()))
+            return false;
+        return dueDt >= startDate && dueDt <= endDate;
+    });
+}
+// ── Live data fetching ───────────────────────────────────────────
+function parseCalendarTable(ch) {
+    const records = [];
+    const table = ch("table").first();
+    if (!table.length)
+        return records;
+    const rows = table.find("tr").toArray();
+    for (const row of rows) {
+        const allCells = ch(row).find("td, th");
+        if (allCells.length < 3)
+            continue;
+        // Skip header rows
+        if (ch(row).find("th").length > 0)
+            continue;
+        const cellTexts = allCells
+            .toArray()
+            .map((cell) => ch(cell).text().trim());
+        // Heuristic: find a cell that looks like an ASX code (2-4 uppercase letters)
+        let ticker = "";
+        let companyName = "";
+        for (let i = 0; i < cellTexts.length; i++) {
+            const stripped = cellTexts[i].trim().toUpperCase();
+            if (stripped.length >= 2 &&
+                stripped.length <= 4 &&
+                /^[A-Z]+$/.test(stripped) &&
+                !ticker) {
+                ticker = stripped;
+                // Next cell is usually the company name
+                if (i + 1 < cellTexts.length) {
+                    companyName = cellTexts[i + 1];
+                }
+                break;
+            }
+        }
+        if (!ticker)
+            continue;
+        // Look for date-like cells
+        let dueDateStr = "";
+        let lodgedDateStr = null;
+        for (const text of cellTexts) {
+            const parsed = tryParseDate(text);
+            if (parsed) {
+                const dateIso = formatDateIso(parsed);
+                if (!dueDateStr) {
+                    dueDateStr = dateIso;
+                }
+                else if (!lodgedDateStr) {
+                    lodgedDateStr = dateIso;
+                }
+            }
+        }
+        if (!dueDateStr)
+            continue;
+        const quarterEnd = inferQuarterEnd(new Date(dueDateStr));
+        const status = determineStatus(dueDateStr, lodgedDateStr);
+        records.push({
+            ticker,
+            company_name: companyName,
+            quarter_end: quarterEnd,
+            due_date: dueDateStr,
+            lodged_date: lodgedDateStr,
+            status,
+        });
+    }
+    return records;
+}
+export async function fetchCalendarLive() {
+    try {
+        const ch = await fetchHtml(LISTCORP_UPCOMING_URL);
+        return parseCalendarTable(ch);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[error] Failed to fetch calendar page: ${msg}`);
+        return [];
+    }
+}
+// ── Main entry point ─────────────────────────────────────────────
+/**
+ * Fetch and filter ASX 4C calendar entries.
+ *
+ * @param options.tickers - Comma-separated tickers or "all"
+ * @param options.period - Period string (next_30d, Q1_2026, etc.)
+ * @param options.records - Pre-fetched records (for testing / offline use)
+ */
+export async function fetchCalendar(options) {
+    const tickersInput = options?.tickers ?? "all";
+    const periodStr = options?.period ?? "next_30d";
+    const { start: startDate, end: endDate } = parsePeriod(periodStr);
+    // Parse ticker filter
+    let filterTickers = null;
+    if (tickersInput.trim().toLowerCase() !== "all") {
+        filterTickers = tickersInput
+            .split(",")
+            .map((t) => t.trim())
+            .filter(Boolean);
+        if (!filterTickers.length)
+            filterTickers = null;
+    }
+    // Fetch data
+    let records = options?.records ?? (await fetchCalendarLive());
+    if (!records.length)
+        return [];
+    // Apply filters
+    records = filterByPeriod(records, startDate, endDate);
+    if (filterTickers) {
+        records = filterByTickers(records, filterTickers);
+    }
+    // Sort by due_date ascending
+    records.sort((a, b) => a.due_date.localeCompare(b.due_date));
+    return records;
+}
+export { OUTPUT_COLUMNS };
+//# sourceMappingURL=asx-calendar-fetcher.js.map

package/dist/investigation-tools/asx-calendar-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asx-calendar-fetcher.js","sourceRoot":"","sources":["../../src/investigation-tools/asx-calendar-fetcher.ts"],"names":[],"mappings":"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"}

package/dist/investigation-tools/asx-parser.d.ts

@@ -0,0 +1,66 @@
+/**
+ * asx-parser.ts – Parse ASX announcements into structured data.
+ *
+ * Supports:
+ *   - Appendix 3Y  (director interest changes / insider trades)
+ *   - Appendix 4C  (quarterly cashflow reports)
+ *   - Trading halts
+ *
+ * Accepts raw text content (pre-extracted from HTML/PDF).
+ */
+/** Recognised ASX announcement types. */
+export type AnnouncementType = "3y" | "4c" | "halt";
+/** Parsed Appendix 3Y director interest notice. */
+export interface Parsed3Y {
+    director_name: string | null;
+    company: string | null;
+    ticker: string | null;
+    date_of_change: string | null;
+    nature_of_interest: string | null;
+    securities_acquired: string | null;
+    securities_disposed: string | null;
+    consideration: number | null;
+    consideration_raw: string | null;
+    associated_entity: string | null;
+}
+/** Parsed Appendix 4C quarterly cashflow report. */
+export interface Parsed4C {
+    company: string | null;
+    ticker: string | null;
+    period: string | null;
+    net_operating_cashflow: number | null;
+    net_investing_cashflow: number | null;
+    net_financing_cashflow: number | null;
+    cash_at_end_of_period: number | null;
+}
+/** Parsed trading halt / voluntary suspension notice. */
+export interface ParsedHalt {
+    company: string | null;
+    ticker: string | null;
+    date: string | null;
+    reason: string | null;
+    expected_resumption: string | null;
+}
+/** Wrapper envelope around any parsed announcement. */
+export interface ParsedEnvelope<T> {
+    type: AnnouncementType;
+    source: string;
+    parsed_at: string;
+    data: T;
+}
+/**
+ * Auto-detect announcement type from raw text content.
+ * Throws if no type can be determined.
+ */
+export declare function detectType(text: string): AnnouncementType;
+/** Parse Appendix 3Y director interest notice from raw text. */
+export declare function parse3y(text: string): Parsed3Y;
+/** Parse Appendix 4C quarterly cashflow report from raw text. */
+export declare function parse4c(text: string): Parsed4C;
+/** Parse trading halt / voluntary suspension notice from raw text. */
+export declare function parseHalt(text: string): ParsedHalt;
+/** Wrap parsed announcement data in a standard envelope. */
+export declare function buildEnvelope<T>(annType: AnnouncementType, source: string, data: T): ParsedEnvelope<T>;
+/** Parse raw text with an explicit or auto-detected type. */
+export declare function parseAnnouncement(text: string, type?: AnnouncementType | "auto", source?: string): ParsedEnvelope<Parsed3Y | Parsed4C | ParsedHalt>;
+//# sourceMappingURL=asx-parser.d.ts.map

package/dist/investigation-tools/asx-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asx-parser.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/asx-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmCH,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAEpD,mDAAmD;AACnD,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT;AAiCD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAyBzD;AA0DD,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAqD9C;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA+D9C;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA0ClD;AAID,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,GACN,cAAc,CAAC,CAAC,CAAC,CAOnB;AAID,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,gBAAgB,GAAG,MAAe,EACxC,MAAM,SAAW,GAChB,cAAc,CAAC,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC,CAWlD"}