@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/forms/forms-builders.js

@@ -0,0 +1,211 @@
+/**
+ * The closed vocabularies + pure logic behind the §10 BUILDER widgets —
+ * `rule-builder`, `flow-builder`, `question-builder`, `column-mapping-table` and
+ * `export-builder`. PURE module (React-free, JSX-free, copy-free), so
+ * `forms-config.ts` can reach it without dragging component code into the eager
+ * registry chunk (04 §2.3).
+ *
+ * WHY EVERY VOCABULARY HERE IS CLOSED: each of these widgets stores its output
+ * in a page manifest and the rule-builder's output is compiled to a SQL WHERE
+ * clause. A manifest that could name an arbitrary operator, node kind or
+ * question type would be naming a renderer — or a predicate — that does not
+ * exist. Config picks FROM these lists; it never extends them.
+ */
+// ── rule-builder (annex §10) ────────────────────────────────────────────────
+/** The column types the field catalog classifies against (annex `operatorsByType`). */
+export const RULE_FIELD_TYPES = ['string', 'number', 'boolean', 'date', 'enum'];
+/** Every operator a condition may name — compiled to SQL WHERE by the host. */
+export const RULE_OPERATORS = [
+    'eq',
+    'neq',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'contains',
+    'not-contains',
+    'starts-with',
+    'in',
+    'before',
+    'after',
+    'is-null',
+    'is-not-null',
+];
+/** ALL/ANY — the pill dividers between condition chips (annex §10). */
+export const RULE_MATCH_MODES = ['all', 'any'];
+/**
+ * The operators offered per column type. The annex's `operatorsByType` config
+ * overrides this map; this is what a generated rule-builder starts from.
+ */
+export const DEFAULT_OPERATORS_BY_TYPE = {
+    string: ['eq', 'neq', 'contains', 'not-contains', 'starts-with', 'is-null', 'is-not-null'],
+    number: ['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'is-null', 'is-not-null'],
+    boolean: ['eq', 'neq'],
+    date: ['before', 'after', 'eq', 'is-null', 'is-not-null'],
+    enum: ['eq', 'neq', 'in', 'is-null', 'is-not-null'],
+};
+/**
+ * Whether an operator needs a value input. `is-null`/`is-not-null` are complete
+ * on their own — rendering a value box beside them would invite the user to type
+ * something the compiled WHERE clause then silently ignores.
+ */
+export function operatorTakesValue(operator) {
+    return operator !== 'is-null' && operator !== 'is-not-null';
+}
+/** The operators valid for a field type, honouring a config override. */
+export function operatorsForType(type, overrides) {
+    const override = overrides?.[type];
+    return override !== undefined && override.length > 0 ? override : DEFAULT_OPERATORS_BY_TYPE[type];
+}
+/**
+ * A condition whose operator its field type does not support is REPAIRED to the
+ * type's first operator rather than dropped: a stored segment that survives a
+ * column's type change should keep the user's field and value and lose only the
+ * part that stopped making sense.
+ */
+export function repairOperator(operator, type, overrides) {
+    const allowed = operatorsForType(type, overrides);
+    if (allowed.includes(operator))
+        return operator;
+    return allowed[0] ?? 'eq';
+}
+// ── flow-builder (annex §10) ────────────────────────────────────────────────
+/** Typed workflow nodes — the annex fixes both the kinds and their tones. */
+export const FLOW_NODE_KINDS = ['trigger', 'condition', 'action'];
+/** annex §10: "trigger=accent, condition=warn, action=pos". */
+export const FLOW_NODE_TONE = {
+    trigger: 'accent',
+    condition: 'warn',
+    action: 'pos',
+};
+/**
+ * Where a new node may be inserted. A flow reads top-down from ONE trigger, so a
+ * palette node of kind `trigger` may only replace/lead the flow — appending a
+ * second trigger halfway down would describe a workflow the engine cannot run.
+ */
+export function canAppendNode(kind, existing) {
+    if (kind !== 'trigger')
+        return true;
+    return !existing.some((node) => node.kind === 'trigger');
+}
+// ── question-builder (annex §10) ────────────────────────────────────────────
+/** The 8 addable question types (annex §10: "palette of 8 addable question types"). */
+export const QUESTION_KINDS = [
+    'single-choice',
+    'multi-choice',
+    'dropdown',
+    'short-text',
+    'long-text',
+    'rating',
+    'nps',
+    'date',
+];
+/** Which kinds carry an editable option list (the rest preview a fixed stub). */
+export function questionTakesOptions(kind) {
+    return kind === 'single-choice' || kind === 'multi-choice' || kind === 'dropdown';
+}
+/** The NPS chip row is 0–10 by definition (annex §10). */
+export const NPS_SCORES = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+/** A star rating previews 5 stars (annex §10 "star rating"). */
+export const RATING_STARS = 5;
+/**
+ * Move an item within an ordered list, returning a NEW array. Out-of-range
+ * moves are no-ops rather than errors — the first card's "up" button is a
+ * legitimate click, not a bug to throw on.
+ */
+export function moveItem(items, from, to) {
+    if (from < 0 || from >= items.length || to < 0 || to >= items.length || from === to)
+        return [...items];
+    const next = [...items];
+    const [moved] = next.splice(from, 1);
+    if (moved === undefined)
+        return [...items];
+    next.splice(to, 0, moved);
+    return next;
+}
+// ── column-mapping-table (annex §10) ────────────────────────────────────────
+/**
+ * The target that means "Don't import" (annex §10). A reserved sentinel rather
+ * than `undefined`, because "the user explicitly skipped this column" and "the
+ * user has not decided yet" must not collapse into the same stored value.
+ */
+export const SKIP_TARGET = '__skip__';
+/** Strip case and separators so `created_at`, `createdAt` and `Created At` match. */
+function normalizeName(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '');
+}
+/** Dice coefficient over character bigrams — 0…1, symmetric, allocation-light. */
+function diceCoefficient(a, b) {
+    if (a.length < 2 || b.length < 2)
+        return 0;
+    const bigrams = new Map();
+    for (let i = 0; i < a.length - 1; i += 1) {
+        const gram = a.slice(i, i + 2);
+        bigrams.set(gram, (bigrams.get(gram) ?? 0) + 1);
+    }
+    let hits = 0;
+    for (let i = 0; i < b.length - 1; i += 1) {
+        const gram = b.slice(i, i + 2);
+        const count = bigrams.get(gram) ?? 0;
+        if (count > 0) {
+            bigrams.set(gram, count - 1);
+            hits += 1;
+        }
+    }
+    return (2 * hits) / (a.length - 1 + (b.length - 1));
+}
+/** Name similarity, 0…1. Exact/prefix/substring short-circuit the bigram score. */
+export function nameSimilarity(a, b) {
+    const left = normalizeName(a);
+    const right = normalizeName(b);
+    if (left === '' || right === '')
+        return 0;
+    if (left === right)
+        return 1;
+    if (left.startsWith(right) || right.startsWith(left))
+        return 0.85;
+    if (left.includes(right) || right.includes(left))
+        return 0.75;
+    return diceCoefficient(left, right);
+}
+/** Below this, a suggestion is a guess the user would have to undo. */
+export const AUTO_MATCH_THRESHOLD = 0.6;
+/**
+ * The best target for a source column by name similarity (annex §10 `autoMatch`),
+ * or `null` when nothing clears the threshold — leaving the picker unset, which
+ * is honest, rather than pre-filling a wrong mapping the user must notice to fix.
+ *
+ * Ties keep the FIRST target in catalog order (strict `>`), so the same schema
+ * always auto-matches the same way (04 §7.7).
+ */
+export function autoMatchTarget(source, targets) {
+    let best = null;
+    let bestScore = 0;
+    for (const target of targets) {
+        if (target.key === SKIP_TARGET)
+            continue;
+        const score = Math.max(nameSimilarity(source, target.key), nameSimilarity(source, target.label ?? ''));
+        if (score > bestScore) {
+            bestScore = score;
+            best = target.key;
+        }
+    }
+    return bestScore >= AUTO_MATCH_THRESHOLD ? best : null;
+}
+// ── export-builder (annex §10) ──────────────────────────────────────────────
+/** The formats the annex's segmented picker offers. */
+export const EXPORT_FORMATS = ['pdf', 'csv', 'xlsx'];
+/** The annex's `idle → running(%) → done(Download)` machine, plus failure. */
+export const EXPORT_PHASES = ['idle', 'running', 'done', 'failed'];
+/**
+ * The phase to render. The PAYLOAD wins whenever it has moved off `idle`: the
+ * host owns the export job, so its status is the truth, and a widget that kept
+ * showing its own optimistic `running` after the host reported `failed` would be
+ * lying about a job the user is waiting on.
+ */
+export function exportPhaseOf(payloadPhase, submitted) {
+    if (payloadPhase !== 'idle')
+        return payloadPhase;
+    return submitted ? 'running' : 'idle';
+}
+//# sourceMappingURL=forms-builders.js.map

package/dist/families/forms/forms-builders.js.map

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