@adminiumjs/llm 0.1.0-rc.1

package/dist/apply/plan.js

@@ -0,0 +1,422 @@
+import { widgetId } from './suggestion-id.js';
+// ─── Span → grid heuristic (§5 / 04-widget-registry.md §6.1) ─────────────────
+/** KPI cards are 3 half-rows (120px); every other widget is 8 (320px). */
+const KPI_HEIGHT = 3;
+const CHART_HEIGHT = 8;
+const GRID_COLUMNS = 12;
+function clampSpan(span) {
+    if (!Number.isFinite(span))
+        return 6;
+    return Math.min(GRID_COLUMNS, Math.max(1, Math.trunc(span)));
+}
+function widgetHeight(width) {
+    return width <= KPI_HEIGHT ? KPI_HEIGHT : CHART_HEIGHT;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+// ─── Query-descriptor binding (04-widget-registry.md §5.1) ───────────────────
+/** Split a qualified `"schema.table"` into a query-descriptor `source` block. */
+function tableSource(qualified) {
+    const dot = qualified.indexOf('.');
+    if (dot <= 0)
+        return { name: qualified, type: 'table' };
+    return { schema: qualified.slice(0, dot), name: qualified.slice(dot + 1), type: 'table' };
+}
+/**
+ * Build a declarative query-descriptor binding for one accepted widget, shaped
+ * from its bound columns: a `timeColumn` ⇒ `timeseries` (month buckets); else a
+ * `dimensionColumn` ⇒ `categorical` (group-by); else `single-metric`. The
+ * aggregation defaults to `sum` when a metric column is bound, else `count(*)`.
+ */
+function buildBinding(connectionId, w) {
+    const source = tableSource(w.table);
+    const fn = w.agg ?? (w.metricColumn !== undefined ? 'sum' : 'count');
+    const aggregation = { fn, alias: 'value' };
+    if (w.metricColumn !== undefined)
+        aggregation['column'] = w.metricColumn;
+    const binding = {
+        kind: 'table-query',
+        connectionId,
+        source,
+        aggregations: [aggregation],
+    };
+    if (w.timeColumn !== undefined) {
+        binding['shape'] = 'timeseries';
+        binding['bucket'] = { column: w.timeColumn, unit: 'month' };
+    }
+    else if (w.dimensionColumn !== undefined) {
+        binding['shape'] = 'categorical';
+        binding['groupBy'] = [w.dimensionColumn];
+        binding['limit'] = 8;
+    }
+    else {
+        binding['shape'] = 'single-metric';
+    }
+    return binding;
+}
+/**
+ * Pack accepted widgets left-to-right on the 12-column grid in rank order,
+ * wrapping to a new shelf when the current row overflows. Pure and deterministic
+ * — widths come from the §5 span heuristic, heights from {@link widgetHeight}.
+ */
+function planLayout(connectionId, dashboardSlug, widgets, accepted) {
+    const chosen = widgets
+        .filter((w) => accepted.has(widgetId(dashboardSlug, w.widget, w.rank)))
+        .slice()
+        .sort((a, b) => a.rank - b.rank);
+    const items = [];
+    const widgetIds = [];
+    let x = 0;
+    let y = 0;
+    let rowHeight = 0;
+    for (const w of chosen) {
+        const width = clampSpan(w.span);
+        const height = widgetHeight(width);
+        if (x + width > GRID_COLUMNS) {
+            x = 0;
+            y += rowHeight;
+            rowHeight = 0;
+        }
+        const id = widgetId(dashboardSlug, w.widget, w.rank);
+        items.push({
+            i: id,
+            widget: w.widget,
+            x,
+            y,
+            w: width,
+            h: height,
+            config: { title: w.titleEn, binding: buildBinding(connectionId, w) },
+        });
+        widgetIds.push(id);
+        x += width;
+        rowHeight = Math.max(rowHeight, height);
+    }
+    return { layout: { version: 1, items }, widgetIds };
+}
+// ─── Per-category descriptor emitters ────────────────────────────────────────
+/** Table-label vs column-label: `label:<table>` is table-scoped, else column. */
+function labelWrite(row) {
+    const value = row.llmValue;
+    if (!isRecord(value) || row.table === undefined)
+        return null;
+    const bundle = value;
+    const body = row.id.slice('label:'.length);
+    const column = body === row.table ? null : body.slice(row.table.length + 1) || null;
+    const json = { label: bundle.label };
+    if (bundle.description !== undefined)
+        json['description'] = bundle.description;
+    // icon rides with the table-label bundle only (§8.1); columns carry no icon.
+    if (column === null && bundle.icon !== undefined)
+        json['icon'] = bundle.icon;
+    return override(row, 'label', row.table, column, json);
+}
+function keyWrite(row) {
+    const value = row.llmValue;
+    if (!isRecord(value) || row.table === undefined)
+        return null;
+    const bundle = value;
+    return override(row, 'key', row.table, null, {
+        displayColumn: bundle.displayColumn ?? null,
+        naturalKey: bundle.naturalKey ?? null,
+    });
+}
+function enumWrite(row) {
+    const value = row.llmValue;
+    if (!isRecord(value) || row.table === undefined)
+        return null;
+    const e = value;
+    const column = row.id.slice(`enum:${row.table}.`.length);
+    return override(row, 'enum_semantics', row.table, column, {
+        kind: e.kind,
+        order: e.order,
+        terminal: e.terminal ?? null,
+        tones: e.tones,
+    });
+}
+/**
+ * Per-relation discriminator for the override upsert key. A `fromTable` can carry
+ * more than one relation (a junction/denormalized table with several undeclared
+ * FKs), and every relation override shares `field`+`table`+`column=null`, so
+ * without this the upsert key `(connection, op, table, column)` collides and all
+ * but the last relation is silently dropped. Encoding the full relation
+ * coordinates (mirroring the §8.1 suggestion id) keeps each distinct relation on
+ * its own row while staying deterministic — re-applying the same run upserts in
+ * place (idempotent), it never inserts a duplicate.
+ */
+function relationColumnKey(fromColumns, toTable, toColumns) {
+    return `${fromColumns.join(',')}->${toTable}.${toColumns.join(',')}`;
+}
+function relationWrite(row) {
+    const value = row.llmValue;
+    if (!isRecord(value) || row.table === undefined)
+        return null;
+    if (row.status === 'rejects-heuristic') {
+        // A confirmed relation the LLM rejects (`correct: false`) → suppress the FK.
+        const rel = value;
+        return override(row, 'relation_suppressed', row.table, relationColumnKey(rel.fromColumns, rel.toTable, rel.toColumns), {
+            fromColumns: rel.fromColumns,
+            toTable: rel.toTable,
+            toColumns: rel.toColumns,
+        });
+    }
+    // An inferred relation the engine should treat as a real FK (§8.3).
+    const rel = value;
+    const json = {
+        fromColumns: rel.fromColumns,
+        toTable: rel.toTable,
+        toColumns: rel.toColumns,
+        kind: rel.kind,
+    };
+    if (rel.viaTable !== undefined)
+        json['viaTable'] = rel.viaTable;
+    return override(row, 'virtual_relation', row.table, relationColumnKey(rel.fromColumns, rel.toTable, rel.toColumns), json);
+}
+function piiWrite(row) {
+    if (row.table === undefined)
+        return null;
+    const column = row.id.slice(`pii:${row.table}.`.length);
+    if (row.status === 'rejects-heuristic') {
+        // Explicit `pii: null` over a heuristic flag → an explicit clear (§8.3).
+        return override(row, 'pii', row.table, column, null);
+    }
+    const value = row.llmValue;
+    if (!isRecord(value))
+        return null;
+    return override(row, 'pii', row.table, column, { ...value });
+}
+function copyWrite(row) {
+    const value = row.llmValue;
+    if (!isRecord(value) || row.table === undefined)
+        return null;
+    return override(row, 'copy', row.table, null, { ...value });
+}
+function groupWrite(row) {
+    const value = row.llmValue;
+    if (!isRecord(value))
+        return null;
+    const g = value;
+    return {
+        target: 'page',
+        kind: 'nav-group',
+        suggestionId: row.id,
+        group: g.id,
+        navOrder: g.order,
+        label: g.label,
+        icon: g.icon,
+        tables: [...g.tables],
+        source: 'llm',
+        confidence: row.confidence,
+    };
+}
+function templateWrite(row, connectionId) {
+    const value = row.llmValue;
+    if (!isRecord(value) || row.table === undefined)
+        return null;
+    const t = value;
+    return {
+        target: 'page',
+        kind: 'template-page',
+        suggestionId: row.id,
+        template: t.template,
+        table: row.table,
+        rank: t.rank,
+        config: { source: { connectionId, table: row.table } },
+        source: 'llm',
+        confidence: row.confidence,
+    };
+}
+function dashboardWrite(row, connectionId, accepted) {
+    const value = row.llmValue;
+    if (!isRecord(value))
+        return null;
+    const d = value;
+    const { layout, widgetIds } = planLayout(connectionId, d.id, d.widgets ?? [], accepted);
+    return {
+        target: 'page',
+        kind: 'dashboard-page',
+        suggestionId: row.id,
+        dashboard: d.id,
+        domain: d.domain,
+        label: d.label,
+        navOrder: d.order,
+        tables: [...d.tables],
+        layout,
+        widgetIds,
+        source: 'llm',
+        confidence: row.confidence,
+    };
+}
+/** Build an {@link OverrideWrite}, omitting `column` semantics via an explicit null. */
+function override(row, field, table, column, value) {
+    return {
+        target: 'override',
+        suggestionId: row.id,
+        field,
+        table,
+        column,
+        value,
+        source: 'llm',
+        confidence: row.confidence,
+    };
+}
+// ─── The planner ─────────────────────────────────────────────────────────────
+/** Categories that never produce a standalone descriptor (widgets fold into dashboards). */
+const FOLDED = new Set(['widget']);
+/** Statuses that carry no LLM value to apply — nothing to write. */
+const NON_ACTIONABLE = new Set([
+    'heuristic-only',
+]);
+/**
+ * Build the ordered {@link ApplyPlan} for the accepted subset of a reviewed diff
+ * (§8.3). Emits one descriptor per accepted suggestion (widgets fold into their
+ * dashboard), excludes `user-locked` targets (provenance), and turns
+ * `rejects-heuristic` acceptances into suppression descriptors.
+ */
+export function buildApplyPlan(diff, acceptedIds, opts) {
+    const accepted = new Set(acceptedIds);
+    const writes = [];
+    const excludedUserLocked = [];
+    for (const row of diff) {
+        if (!accepted.has(row.id))
+            continue;
+        // Provenance user > llm > heuristic: never write over a user edit (§8.3).
+        if (row.status === 'user-locked') {
+            excludedUserLocked.push(row.id);
+            continue;
+        }
+        if (NON_ACTIONABLE.has(row.status))
+            continue;
+        if (FOLDED.has(row.category))
+            continue; // widgets materialize inside dashboards
+        const write = emit(row, opts.connectionId, accepted);
+        if (write !== null)
+            writes.push(write);
+    }
+    const plan = { connectionId: opts.connectionId, writes, excludedUserLocked };
+    if (opts.llmRunId !== undefined)
+        plan.llmRunId = opts.llmRunId;
+    return plan;
+}
+function emit(row, connectionId, accepted) {
+    switch (row.category) {
+        case 'label':
+            return labelWrite(row);
+        case 'key':
+            return keyWrite(row);
+        case 'enum':
+            return enumWrite(row);
+        case 'relation':
+            return relationWrite(row);
+        case 'pii':
+            return piiWrite(row);
+        case 'copy':
+            return copyWrite(row);
+        case 'group':
+            return groupWrite(row);
+        case 'template':
+            return templateWrite(row, connectionId);
+        case 'dashboard':
+            return dashboardWrite(row, connectionId, accepted);
+        case 'widget':
+            return null; // folded — handled above
+    }
+}
+/** Human counts for the review confirmation modal (§10.3, task step 3). */
+export function applyPlanSummary(plan) {
+    const s = {
+        totalWrites: plan.writes.length,
+        overrides: 0,
+        pages: 0,
+        labels: 0,
+        keys: 0,
+        pii: 0,
+        enums: 0,
+        relations: 0,
+        microcopy: 0,
+        navGroups: 0,
+        templatePages: 0,
+        dashboardPages: 0,
+        widgets: 0,
+    };
+    for (const w of plan.writes) {
+        if (w.target === 'override') {
+            s.overrides += 1;
+            switch (w.field) {
+                case 'label':
+                    s.labels += 1;
+                    break;
+                case 'key':
+                    s.keys += 1;
+                    break;
+                case 'pii':
+                    s.pii += 1;
+                    break;
+                case 'enum_semantics':
+                    s.enums += 1;
+                    break;
+                case 'virtual_relation':
+                case 'relation_suppressed':
+                    s.relations += 1;
+                    break;
+                case 'copy':
+                    s.microcopy += 1;
+                    break;
+            }
+        }
+        else {
+            s.pages += 1;
+            if (w.kind === 'nav-group')
+                s.navGroups += 1;
+            else if (w.kind === 'template-page')
+                s.templatePages += 1;
+            else {
+                s.dashboardPages += 1;
+                s.widgets += w.widgetIds.length;
+            }
+        }
+    }
+    return { ...s, text: summaryText(s) };
+}
+function summaryText(s) {
+    const creates = [];
+    if (s.dashboardPages > 0) {
+        creates.push(`${s.dashboardPages} dashboard ${plural(s.dashboardPages, 'page')} (${s.widgets} ${plural(s.widgets, 'widget')})`);
+    }
+    if (s.templatePages > 0)
+        creates.push(`${s.templatePages} template ${plural(s.templatePages, 'page')}`);
+    const updates = [];
+    if (s.labels > 0)
+        updates.push(`${s.labels} ${plural(s.labels, 'label')}`);
+    if (s.keys > 0)
+        updates.push(`${s.keys} key ${plural(s.keys, 'column')}`);
+    if (s.enums > 0)
+        updates.push(`${s.enums} enum ${plural(s.enums, 'semantic')}`);
+    if (s.relations > 0)
+        updates.push(`${s.relations} ${plural(s.relations, 'relation')}`);
+    if (s.pii > 0)
+        updates.push(`${s.pii} PII ${plural(s.pii, 'flag')}`);
+    if (s.microcopy > 0)
+        updates.push(`${s.microcopy} micro-copy ${plural(s.microcopy, 'block')}`);
+    if (s.navGroups > 0)
+        updates.push(`${s.navGroups} nav ${plural(s.navGroups, 'group')}`);
+    const clauses = [];
+    if (creates.length > 0)
+        clauses.push(`Creates ${joinList(creates)}`);
+    if (updates.length > 0)
+        clauses.push(`${creates.length > 0 ? 'updates' : 'Updates'} ${joinList(updates)}`);
+    if (clauses.length === 0)
+        return 'No changes to apply.';
+    return `${clauses.join('; ')}.`;
+}
+function plural(n, word) {
+    return n === 1 ? word : `${word}s`;
+}
+function joinList(parts) {
+    if (parts.length <= 1)
+        return parts.join('');
+    if (parts.length === 2)
+        return `${parts[0]} and ${parts[1]}`;
+    return `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`;
+}
+//# sourceMappingURL=plan.js.map

package/dist/apply/plan.js.map

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

package/dist/apply/suggestion-id.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Stable suggestion identity (06-llm-assist.md §8.1).
+ *
+ * Every atomic suggestion gets a deterministic id so accept/reject state
+ * survives a reload and re-application is idempotent. Ids are pure functions of
+ * the suggestion's coordinates — no timestamps, no counters, no ordering — so
+ * the same suggestion always maps to the same id regardless of when or in what
+ * order it is produced.
+ *
+ * Scheme (§8.1):
+ *   label:public.orders                  table label+description+icon bundle
+ *   label:public.orders.total_cents      column label+description bundle
+ *   key:public.orders                    displayColumn + naturalKey
+ *   enum:public.orders.status
+ *   relation:public.orders.product_id->public.products.id
+ *   pii:public.customers.email
+ *   template:public.orders:page-queue-inbox
+ *   group:sales
+ *   dashboard:revenue
+ *   widget:revenue:chart-line-area:3     dashboardId:widgetId:rank
+ *   copy:public.orders                   microcopy bundle
+ */
+/** The id-prefix vocabulary. `label` is shared by table- and column-label ids. */
+export declare const SUGGESTION_ID_PREFIXES: readonly ["label", "key", "enum", "relation", "pii", "template", "group", "dashboard", "widget", "copy"];
+export type SuggestionIdPrefix = (typeof SUGGESTION_ID_PREFIXES)[number];
+/** `label:<table>` — the table's label + description + icon bundle. */
+export declare function tableLabelId(table: string): string;
+/** `label:<table>.<column>` — a column's label + description bundle. */
+export declare function columnLabelId(table: string, column: string): string;
+/** `key:<table>` — the displayColumn + naturalKey bundle. */
+export declare function keyId(table: string): string;
+/** `enum:<table>.<column>` — enum semantics for one column. */
+export declare function enumId(table: string, column: string): string;
+/**
+ * `relation:<fromTable>.<fromCols>-><toTable>.<toCols>` — one inferred/confirmed
+ * relation. Composite endpoints join their columns with `,` so multi-column FKs
+ * stay distinct and stable.
+ */
+export declare function relationId(fromTable: string, fromColumns: readonly string[], toTable: string, toColumns: readonly string[]): string;
+/** `pii:<table>.<column>` — a column's PII flag + masking suggestion. */
+export declare function piiId(table: string, column: string): string;
+/** `template:<table>:<template>` — one page-template recommendation for a table. */
+export declare function templateId(table: string, template: string): string;
+/** `group:<slug>` — a navigation group. */
+export declare function groupId(group: string): string;
+/** `dashboard:<slug>` — a dashboard. */
+export declare function dashboardId(dashboard: string): string;
+/** `widget:<dashboard>:<widget>:<rank>` — one widget within a dashboard. */
+export declare function widgetId(dashboard: string, widget: string, rank: number): string;
+/** `copy:<table>` — the micro-copy bundle (empty state + subtitle) for a table. */
+export declare function copyId(table: string): string;
+/**
+ * A reference to any atomic suggestion. `suggestionId(ref)` turns it into the
+ * stable §8.1 id — the single entry point diff.ts / apply.ts use so the id
+ * scheme lives in exactly one place.
+ */
+export type SuggestionRef = {
+    readonly kind: 'table-label';
+    readonly table: string;
+} | {
+    readonly kind: 'column-label';
+    readonly table: string;
+    readonly column: string;
+} | {
+    readonly kind: 'key';
+    readonly table: string;
+} | {
+    readonly kind: 'enum';
+    readonly table: string;
+    readonly column: string;
+} | {
+    readonly kind: 'relation';
+    readonly fromTable: string;
+    readonly fromColumns: readonly string[];
+    readonly toTable: string;
+    readonly toColumns: readonly string[];
+} | {
+    readonly kind: 'pii';
+    readonly table: string;
+    readonly column: string;
+} | {
+    readonly kind: 'template';
+    readonly table: string;
+    readonly template: string;
+} | {
+    readonly kind: 'group';
+    readonly group: string;
+} | {
+    readonly kind: 'dashboard';
+    readonly dashboard: string;
+} | {
+    readonly kind: 'widget';
+    readonly dashboard: string;
+    readonly widget: string;
+    readonly rank: number;
+} | {
+    readonly kind: 'copy';
+    readonly table: string;
+};
+export declare function suggestionId(ref: SuggestionRef): string;
+/** Extract the leading `<prefix>:` token of a suggestion id, if it is a known prefix. */
+export declare function suggestionIdPrefix(id: string): SuggestionIdPrefix | null;
+//# sourceMappingURL=suggestion-id.d.ts.map

package/dist/apply/suggestion-id.d.ts.map

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

package/dist/apply/suggestion-id.js

@@ -0,0 +1,121 @@
+/**
+ * Stable suggestion identity (06-llm-assist.md §8.1).
+ *
+ * Every atomic suggestion gets a deterministic id so accept/reject state
+ * survives a reload and re-application is idempotent. Ids are pure functions of
+ * the suggestion's coordinates — no timestamps, no counters, no ordering — so
+ * the same suggestion always maps to the same id regardless of when or in what
+ * order it is produced.
+ *
+ * Scheme (§8.1):
+ *   label:public.orders                  table label+description+icon bundle
+ *   label:public.orders.total_cents      column label+description bundle
+ *   key:public.orders                    displayColumn + naturalKey
+ *   enum:public.orders.status
+ *   relation:public.orders.product_id->public.products.id
+ *   pii:public.customers.email
+ *   template:public.orders:page-queue-inbox
+ *   group:sales
+ *   dashboard:revenue
+ *   widget:revenue:chart-line-area:3     dashboardId:widgetId:rank
+ *   copy:public.orders                   microcopy bundle
+ */
+/** The id-prefix vocabulary. `label` is shared by table- and column-label ids. */
+export const SUGGESTION_ID_PREFIXES = [
+    'label',
+    'key',
+    'enum',
+    'relation',
+    'pii',
+    'template',
+    'group',
+    'dashboard',
+    'widget',
+    'copy',
+];
+// ─── Constructors ────────────────────────────────────────────────────────────
+/** `label:<table>` — the table's label + description + icon bundle. */
+export function tableLabelId(table) {
+    return `label:${table}`;
+}
+/** `label:<table>.<column>` — a column's label + description bundle. */
+export function columnLabelId(table, column) {
+    return `label:${table}.${column}`;
+}
+/** `key:<table>` — the displayColumn + naturalKey bundle. */
+export function keyId(table) {
+    return `key:${table}`;
+}
+/** `enum:<table>.<column>` — enum semantics for one column. */
+export function enumId(table, column) {
+    return `enum:${table}.${column}`;
+}
+/**
+ * `relation:<fromTable>.<fromCols>-><toTable>.<toCols>` — one inferred/confirmed
+ * relation. Composite endpoints join their columns with `,` so multi-column FKs
+ * stay distinct and stable.
+ */
+export function relationId(fromTable, fromColumns, toTable, toColumns) {
+    return `relation:${fromTable}.${fromColumns.join(',')}->${toTable}.${toColumns.join(',')}`;
+}
+/** `pii:<table>.<column>` — a column's PII flag + masking suggestion. */
+export function piiId(table, column) {
+    return `pii:${table}.${column}`;
+}
+/** `template:<table>:<template>` — one page-template recommendation for a table. */
+export function templateId(table, template) {
+    return `template:${table}:${template}`;
+}
+/** `group:<slug>` — a navigation group. */
+export function groupId(group) {
+    return `group:${group}`;
+}
+/** `dashboard:<slug>` — a dashboard. */
+export function dashboardId(dashboard) {
+    return `dashboard:${dashboard}`;
+}
+/** `widget:<dashboard>:<widget>:<rank>` — one widget within a dashboard. */
+export function widgetId(dashboard, widget, rank) {
+    return `widget:${dashboard}:${widget}:${rank}`;
+}
+/** `copy:<table>` — the micro-copy bundle (empty state + subtitle) for a table. */
+export function copyId(table) {
+    return `copy:${table}`;
+}
+export function suggestionId(ref) {
+    switch (ref.kind) {
+        case 'table-label':
+            return tableLabelId(ref.table);
+        case 'column-label':
+            return columnLabelId(ref.table, ref.column);
+        case 'key':
+            return keyId(ref.table);
+        case 'enum':
+            return enumId(ref.table, ref.column);
+        case 'relation':
+            return relationId(ref.fromTable, ref.fromColumns, ref.toTable, ref.toColumns);
+        case 'pii':
+            return piiId(ref.table, ref.column);
+        case 'template':
+            return templateId(ref.table, ref.template);
+        case 'group':
+            return groupId(ref.group);
+        case 'dashboard':
+            return dashboardId(ref.dashboard);
+        case 'widget':
+            return widgetId(ref.dashboard, ref.widget, ref.rank);
+        case 'copy':
+            return copyId(ref.table);
+    }
+}
+/** Extract the leading `<prefix>:` token of a suggestion id, if it is a known prefix. */
+export function suggestionIdPrefix(id) {
+    const colon = id.indexOf(':');
+    if (colon <= 0)
+        return null;
+    const prefix = id.slice(0, colon);
+    return SUGGESTION_ID_PREFIXES.includes(prefix)
+        ? prefix
+        : null;
+}
+//# sourceMappingURL=suggestion-id.js.map