base-paint 0.3.13 → 0.3.15

package/dist/components/gantt-timeline/model.js

@@ -0,0 +1,222 @@
+/** gantt-timeline · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不"描到最近的格线"：
+ *      描歪了的条会让人按刻度数出一个错的时间。
+ *   2. **归一化只做形状**：格数、刻度文字、时间跨度都在这里定完；**落位与图例在 `layout.ts`**。
+ *   3. 落位的算术**只有一处**（`scale.ts`）：本件不自己再算一遍百分比，也不把数字塞进字符串再抠回来。
+ *
+ *  本件是**唯一入参入口**：`render.ts` 只吃这里产出的 `GanttTimelineModel`，不再自己碰 `any`。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { GANTT_TIMELINE_DEFAULT_CELL_MINUTES, GANTT_TIMELINE_FORMS, GANTT_TIMELINE_IDLE_MIN_CELLS, GANTT_TIMELINE_MAX_CELLS, GANTT_TIMELINE_MAX_KEY_STEPS, GANTT_TIMELINE_MAX_LANES, GANTT_TIMELINE_MAX_MILESTONES, GANTT_TIMELINE_MIN_KEY_STEPS, GANTT_TIMELINE_STATES, } from './attrs.js';
+import { laneEndMinutes, layoutGanttTimeline, } from './layout.js';
+import { isOnGrid, scaleOf, tickCount, ticksOf } from './scale.js';
+/** 本件的缺省口径句（**这一句是这一件的读数纪律，不是装饰**）。 */
+const DEFAULT_NOTE = '口径：一行＝一条泳道（不是一道菜），问的是这条资源什么时候空。'
+    + '关键路径单独一条，标 1 起的顺序号。空档段画成点线块并写分钟数，不装作占用。';
+/* ── 入参小件（数字／状态／格线） ─────────────────────────────────── */
+function num(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        badInput(field + ' 必须是有限数字');
+    return value;
+}
+function optNum(value, field) {
+    return value === undefined ? undefined : num(value, field);
+}
+/** 落在格线上（段的起止必须踩格线：本件不许"描到最近的格线"）。 */
+function onGrid(value, cellMinutes, field) {
+    if (!isOnGrid(value, cellMinutes)) {
+        badInput(field + ' 必须落在格线上（每格 ' + String(cellMinutes) + ' 分钟）：' + String(value));
+    }
+    return value;
+}
+function reqState(value, field) {
+    if (value === undefined)
+        return 'plan';
+    if (!GANTT_TIMELINE_STATES.includes(value)) {
+        badInput(field + ' 必须是 ' + GANTT_TIMELINE_STATES.join('／') + ' 之一');
+    }
+    return value;
+}
+/* ── 泳道 ─────────────────────────────────────────────────────────── */
+function parseSegments(raw, laneLabel, cellMinutes) {
+    if (!Array.isArray(raw))
+        badInput('gantt-timeline: input.lanes[].segments 必须是数组（空数组＝整段时间都空着）');
+    const out = [];
+    const taken = [];
+    raw.forEach((item, i) => {
+        const where = 'gantt-timeline: input.lanes(' + laneLabel + ').segments[' + String(i) + ']';
+        assertPlainObject(item, where);
+        const one = item;
+        const state = reqState(one.state, where + '.state');
+        const from = onGrid(num(one.from, where + '.from'), cellMinutes, where + '.from');
+        if (from < 0)
+            badInput(where + '.from 不能是负数（时间轴从 0 起）');
+        const minutes = num(one.minutes, where + '.minutes');
+        if (minutes <= 0)
+            badInput(where + '.minutes 必须是正数');
+        const to = from + minutes;
+        onGrid(to, cellMinutes, where + '.from 与 minutes 之和');
+        if (state === 'idle' && minutes / cellMinutes < GANTT_TIMELINE_IDLE_MIN_CELLS - 1e-9) {
+            badInput(where + '.minutes 太短：空档段至少要占 ' + String(GANTT_TIMELINE_IDLE_MIN_CELLS)
+                + ' 格（再短的块里那枚分钟数要拆成好几行才放得下）');
+        }
+        /* 重叠判在分钟上：容差按**格宽**折（绝对值在细格下会把"首尾相接"误判成重叠）。 */
+        const touch = cellMinutes * 1e-9;
+        for (const span of taken) {
+            if (from < span.to - touch && to > span.from + touch) {
+                badInput(where + ' 与同一条泳道里另一段压在了一起（' + String(span.from) + '–' + String(span.to)
+                    + ' 分钟）：一条资源同一时刻只做一件事');
+            }
+        }
+        taken.push({ from, to });
+        out.push({ from, minutes, state, label: optText(one.label, where + '.label') });
+    });
+    return out;
+}
+function parseLanes(raw, cellMinutes) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        badInput('gantt-timeline: input.lanes 必须是非空数组（一条泳道＝一条资源）');
+    }
+    if (raw.length > GANTT_TIMELINE_MAX_LANES) {
+        badInput('gantt-timeline: input.lanes 最多 ' + String(GANTT_TIMELINE_MAX_LANES)
+            + ' 条（一屏再多就读不出哪条空着）');
+    }
+    return raw.map((item, i) => {
+        const where = 'gantt-timeline: input.lanes[' + String(i) + ']';
+        assertPlainObject(item, where);
+        const one = item;
+        const label = reqText(one.label, where + '.label');
+        return {
+            label,
+            note: optText(one.note, where + '.note'),
+            segments: parseSegments(one.segments, label, cellMinutes),
+        };
+    });
+}
+/* ── 三块可选的读数（关键路径／里程碑／游标） ─────────────────────── */
+function parseKeyPath(raw, cellMinutes) {
+    assertPlainObject(raw, 'gantt-timeline: input.keyPath');
+    const one = raw;
+    if (!Array.isArray(one.steps))
+        badInput('gantt-timeline: input.keyPath.steps 必须是数组');
+    const n = one.steps.length;
+    if (n < GANTT_TIMELINE_MIN_KEY_STEPS || n > GANTT_TIMELINE_MAX_KEY_STEPS) {
+        badInput('gantt-timeline: input.keyPath.steps 要有 ' + String(GANTT_TIMELINE_MIN_KEY_STEPS) + '–'
+            + String(GANTT_TIMELINE_MAX_KEY_STEPS) + ' 段（一段不是路径）');
+    }
+    const steps = [];
+    one.steps.forEach((item, i) => {
+        const where = 'gantt-timeline: input.keyPath.steps[' + String(i) + ']';
+        assertPlainObject(item, where);
+        const step = item;
+        const minutes = num(step.minutes, where + '.minutes');
+        if (minutes <= 0)
+            badInput(where + '.minutes 必须是正数');
+        onGrid(minutes, cellMinutes, where + '.minutes');
+        steps.push({ name: reqText(step.name, where + '.name'), minutes });
+    });
+    return {
+        label: optText(one.label, 'gantt-timeline: input.keyPath.label') ?? '关键路径',
+        note: optText(one.note, 'gantt-timeline: input.keyPath.note') ?? '不能并行的 ' + String(n) + ' 段',
+        steps,
+    };
+}
+function parseMilestones(raw, cellMinutes) {
+    if (!Array.isArray(raw))
+        badInput('gantt-timeline: input.milestones 必须是数组');
+    if (raw.length > GANTT_TIMELINE_MAX_MILESTONES) {
+        badInput('gantt-timeline: input.milestones 最多 ' + String(GANTT_TIMELINE_MAX_MILESTONES) + ' 个');
+    }
+    return raw.map((item, i) => {
+        const where = 'gantt-timeline: input.milestones[' + String(i) + ']';
+        assertPlainObject(item, where);
+        const one = item;
+        const at = onGrid(num(one.at, where + '.at'), cellMinutes, where + '.at');
+        /* 负数必须自己拦：`-10` 是 `cellMinutes` 的整数倍（格号 -2），"在格线上"这一步放它过去，
+           画出来却落在第 0 分那条格线上（`grid-column: 1`），读数还照写「-10 分 里程碑」。
+           与本件 `segments[].from`／`cursor.at` 同一口径：时间轴从 0 起，负数当场拒。 */
+        if (at < 0)
+            badInput(where + '.at 不能是负数（时间轴从 0 起）');
+        return {
+            at,
+            label: reqText(one.label, where + '.label'),
+            note: optText(one.note, where + '.note') ?? String(at) + ' 分 里程碑',
+        };
+    });
+}
+function parseCursor(raw) {
+    assertPlainObject(raw, 'gantt-timeline: input.cursor');
+    const one = raw;
+    const at = num(one.at, 'gantt-timeline: input.cursor.at');
+    if (at < 0)
+        badInput('gantt-timeline: input.cursor.at 不能是负数');
+    return { at, label: reqText(one.label, 'gantt-timeline: input.cursor.label') };
+}
+/* ── 归一化入口 ───────────────────────────────────────────────────── */
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `GanttTimelineModel`。 */
+export function normalizeGanttTimeline(input) {
+    assertPlainObject(input, 'renderGanttTimeline: input');
+    const raw = input;
+    const form = raw.form === undefined ? GANTT_TIMELINE_FORMS[0] : raw.form;
+    if (!GANTT_TIMELINE_FORMS.includes(form)) {
+        badInput('gantt-timeline: input.form 必须是 ' + GANTT_TIMELINE_FORMS.join('／')
+            + ' 之一（本件只落地形态 C「资源泳道（灶位）× 关键路径带」）');
+    }
+    const cellMinutes = optNum(raw.cellMinutes, 'gantt-timeline: input.cellMinutes')
+        ?? GANTT_TIMELINE_DEFAULT_CELL_MINUTES;
+    if (!(cellMinutes > 0))
+        badInput('gantt-timeline: input.cellMinutes 必须是正数');
+    const title = reqText(raw.title, 'gantt-timeline: input.title');
+    const lanes = parseLanes(raw.lanes, cellMinutes);
+    const keyPath = raw.keyPath === undefined ? undefined : parseKeyPath(raw.keyPath, cellMinutes);
+    const milestones = raw.milestones === undefined ? [] : parseMilestones(raw.milestones, cellMinutes);
+    const cursor = raw.cursor === undefined ? undefined : parseCursor(raw.cursor);
+    /* 时间跨度：**按数据算**（最晚的一处），调用方给的那一档只当"至少到这儿"。 */
+    let end = Math.max(cursor === undefined ? 0 : cursor.at, cellMinutes);
+    for (const lane of lanes)
+        end = Math.max(end, laneEndMinutes(lane));
+    if (keyPath !== undefined)
+        end = Math.max(end, keyPath.steps.reduce((sum, s) => sum + s.minutes, 0));
+    for (const m of milestones)
+        end = Math.max(end, m.at);
+    const asked = optNum(raw.spanMinutes, 'gantt-timeline: input.spanMinutes');
+    if (asked !== undefined && !(asked > 0))
+        badInput('gantt-timeline: input.spanMinutes 必须是正数');
+    if (Math.ceil(Math.max(asked ?? 0, end) / cellMinutes - 1e-6) > GANTT_TIMELINE_MAX_CELLS) {
+        badInput('gantt-timeline: 时间跨度 ' + String(Math.max(asked ?? 0, end)) + ' 分钟 ÷ 每格 '
+            + String(cellMinutes) + ' 分钟 超过 ' + String(GANTT_TIMELINE_MAX_CELLS)
+            + ' 格：请把 input.cellMinutes 调大（刻度放粗）');
+    }
+    const scale = scaleOf(Math.max(asked ?? 0, end), cellMinutes);
+    /* 刻度文字：枚数必须与算出来的刻度数一致（刻度只有一处算）。 */
+    let tickText;
+    if (raw.tickText !== undefined) {
+        if (!Array.isArray(raw.tickText))
+            badInput('gantt-timeline: input.tickText 必须是字符串数组');
+        const want = tickCount(scale.cells);
+        if (raw.tickText.length !== want) {
+            const every = want <= 1 ? scale.cells : scale.cells / want;
+            badInput('gantt-timeline: input.tickText 要有 ' + String(want) + ' 枚（这个跨度下每 '
+                + String(every) + ' 格一枚刻度）');
+        }
+        tickText = raw.tickText.map((t, i) => reqText(t, 'gantt-timeline: input.tickText[' + String(i) + ']'));
+    }
+    const readings = {
+        form: form,
+        title,
+        stamp: optText(raw.stamp, 'gantt-timeline: input.stamp') ?? String(lanes.length) + ' 条泳道',
+        tail: optText(raw.tail, 'gantt-timeline: input.tail'),
+        axisName: optText(raw.axisName, 'gantt-timeline: input.axisName') ?? '分钟',
+        scale,
+        ticks: ticksOf(scale, tickText),
+        keyPath,
+        lanes,
+        milestones,
+        cursor,
+        note: optText(raw.note, 'gantt-timeline: input.note') ?? DEFAULT_NOTE,
+        extraClass: optExtraClass(raw.extraClass, 'gantt-timeline: input.extraClass'),
+    };
+    return { ...readings, ...layoutGanttTimeline(readings) };
+}

package/dist/components/gantt-timeline/model.js.map

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

package/dist/components/gantt-timeline/render.d.ts

@@ -0,0 +1,3 @@
+/** 渲染甘特时间线（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export declare function renderGanttTimeline(input: unknown): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/gantt-timeline/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/gantt-timeline/render.ts"],"names":[],"mappings":"AAqJA,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI1D"}

package/dist/components/gantt-timeline/render.js

@@ -0,0 +1,138 @@
+/** gantt-timeline · **渲染**（纯函数产 HTML；本件只有形态 C「资源泳道（灶位）× 关键路径带」一种骨架）。
+ *
+ *  —— 形态 C 的骨架（与原型逐层对得上）——
+ *
+ *  ① 卡头：标题 ＋「几条泳道」＋ 右端那句读数；
+ *  ② 刻度行：左端量名（窄档折到刻度之上）＋ 格刻度（**每 N 格写一枚数字**，数字由轴域算）；
+ *  ③ 泳道区（`role="img"`）：**关键路径一条** ＋ **资源泳道各一条** ＋ 里程碑各一条；
+ *     段按状态给字形（`✓`／`▶`／`⋯`／`▷`），空档段是点线块并写分钟数，里程碑是压在格线上的 `◆`；
+ *     「现在」游标是一条竖线 ＋ 线上一枚字（靠右半区时字挪到线的左侧）；
+ *  ④ 图例（**只列这一段实际出现过的档**：形 ＋ 字）；⑤ 口径行。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · **落位只有一处算**：段／空档块／里程碑／游标的坐标全部来自 `scale.ts` 的同一个轴域；
+ *   · **窄档零横向溢出靠换行、不靠截断**：长的名字／读数一律 `overflow-wrap:anywhere`，
+ *     本件**不写** `overflow:hidden`、不写 `text-overflow`、不写省略号；
+ *   · 标记里**不写分隔符**（段间那道缝由列距与格线承担），也不写脚本。
+ */
+import { esc } from '../shared/escape.js';
+import { GANTT_TIMELINE_AT_VAR, GANTT_TIMELINE_CLASS, ganttTimelineSlot, ganttTimelineStateClass, } from './attrs.js';
+import { normalizeGanttTimeline } from './model.js';
+/** 格的列宽（**唯一的格子写法**）：格数与落位是同一份事实，故这里只写一次。 */
+const gridStyle = (cells) => ' style="grid-template-columns:repeat(' + String(cells) + ',minmax(0,1fr))"';
+/** 卡头：标题 ＋「几条泳道」＋ 右端读数（薄薄一排；不放按钮——按钮归 `action-bar`）。 */
+function headHtml(m) {
+    const parts = ['<div class="' + ganttTimelineSlot('hd') + '">'];
+    parts.push('<b class="' + ganttTimelineSlot('title') + '">' + esc(m.title) + '</b>');
+    parts.push('<span class="' + ganttTimelineSlot('stamp') + '">' + esc(m.stamp) + '</span>');
+    if (m.tail !== undefined) {
+        parts.push('<span class="' + ganttTimelineSlot('tail') + '">' + esc(m.tail) + '</span>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 刻度行：量名 ＋ 逐格一枚 `i`（有数字的那几格多一枚 `b`）。
+ *  数字的宽度上限＝**相邻两枚刻度之间的格数**（那是它真正能用的地方）：长了在那一整段里换行，
+ *  最后一格上的数字改右对齐（往左长，跑不出刻度区）——本件不写省略号、也不让它跑出去。 */
+function axisHtml(m) {
+    const labelled = new Map(m.ticks.map((t) => [t.index, t]));
+    const step = m.ticks.length > 1 ? m.ticks[1].index - m.ticks[0].index : m.scale.cells;
+    const width = ' style="max-width:calc(100% * ' + String(step) + ')"';
+    const parts = ['<div class="' + ganttTimelineSlot('axrow') + '">'];
+    parts.push('<span class="' + ganttTimelineSlot('lbh') + '">' + esc(m.axisName) + '</span>');
+    parts.push('<div class="' + ganttTimelineSlot('ax') + '" aria-hidden="true"' + gridStyle(m.scale.cells) + '>');
+    for (let i = 0; i < m.scale.cells; i += 1) {
+        const tick = labelled.get(i);
+        if (tick === undefined) {
+            parts.push('<i class="' + ganttTimelineSlot('tick') + '"></i>');
+            continue;
+        }
+        parts.push('<i class="' + ganttTimelineSlot('tick') + ' is-num"><b class="' + ganttTimelineSlot('tick-label')
+            + (tick.atEnd ? ' is-end' : '') + '"' + width + '>' + esc(tick.text) + '</b></i>');
+    }
+    parts.push('</div></div>');
+    return parts.join('');
+}
+/** 一条段（或空档块）：落位、宽度、字形、悬停读数都从 `mark` 来——**不在这里算坐标**。 */
+function markHtml(mark) {
+    /* 带短字 ⇒ 这块面上有正文级的字：另加一枚修饰类，样式段据此改走「有文字的选中面」
+       （实底上放正文在 neutral 皮肤下过不了文本地板）。`is-` 那一段只有一个拼法。 */
+    const words = mark.text === undefined || mark.text === '' ? '' : ' is-labelled';
+    const cls = mark.state === 'idle' ? ganttTimelineSlot('idle')
+        : ganttTimelineSlot('bar') + ' ' + ganttTimelineStateClass(mark.state) + words;
+    const parts = ['<span class="' + cls + '" style="grid-column:' + String(mark.column)
+            + ' / span ' + String(mark.span) + '" title="' + esc(mark.title) + '">'];
+    if (mark.mark !== '')
+        parts.push('<i class="' + ganttTimelineSlot('mark') + '">' + esc(mark.mark) + '</i>');
+    if (mark.text !== undefined && mark.text !== '') {
+        parts.push('<span class="' + ganttTimelineSlot('text') + '">' + esc(mark.text) + '</span>');
+    }
+    parts.push('</span>');
+    return parts.join('');
+}
+/** 一个里程碑：元素铺到一侧、`◆` 压在格线上；名字写在 `◆` 旁边（长了换行、不截断）。 */
+function milestoneHtml(mark, label) {
+    return '<span class="' + ganttTimelineSlot('milestone') + (mark.atEnd ? ' is-end' : '')
+        + '" style="grid-column:' + String(mark.column) + ' / span ' + String(mark.span)
+        + '" title="' + esc(mark.title) + '">'
+        + '<i class="' + ganttTimelineSlot('ms-mark') + '">' + esc(mark.mark) + '</i>'
+        + '<span class="' + ganttTimelineSlot('ms-text') + '">' + esc(label) + '</span></span>';
+}
+/** 行：左端标签（宽档在左侧列、窄档折到轨迹之上）＋ 轨迹。 */
+function rowHtml(row, cells) {
+    const parts = ['<div class="' + ganttTimelineSlot('row') + ' ' + row.kindClass + '">'];
+    parts.push('<span class="' + ganttTimelineSlot('row-label') + '">'
+        + '<b class="' + ganttTimelineSlot('row-name') + '">' + esc(row.label) + '</b>'
+        + '<em class="' + ganttTimelineSlot('row-note') + '">' + esc(row.note) + '</em></span>');
+    parts.push('<span class="' + ganttTimelineSlot('track') + '"' + gridStyle(cells) + '>');
+    for (const mark of row.marks) {
+        parts.push(row.kind === 'milestone' ? milestoneHtml(mark, row.label) : markHtml(mark));
+    }
+    parts.push('</span></div>');
+    return parts.join('');
+}
+/** 泳道区：先排「现在」游标那枚字（**它自己占一行**——原型里它正压在关键路径那一条上，因为那版把它
+ *  绝对定位在一段固定高度的带里、字一换行就盖住下面那一行），再逐行排（关键路径 → 泳道 → 里程碑）。
+ *  游标位置经 `GANTT_TIMELINE_AT_VAR` 传给样式（竖线与那枚字读的是同一个数）。 */
+function bodyHtml(m) {
+    const parts = ['<div class="' + ganttTimelineSlot('body')
+            + '" role="img" aria-label="' + esc(m.ariaLabel) + '"'
+            + (m.cursorView === undefined ? '' : ' style="' + GANTT_TIMELINE_AT_VAR + ':'
+                + String(m.cursorView.ratio) + '"') + '>'];
+    if (m.cursorView !== undefined) {
+        parts.push('<b class="' + ganttTimelineSlot('now-label') + (m.cursorView.atEnd ? ' is-end' : '') + '">'
+            + esc(m.cursorView.label) + '</b>');
+        parts.push('<span class="' + ganttTimelineSlot('now') + '" aria-hidden="true"></span>');
+    }
+    for (const row of m.rows)
+        parts.push(rowHtml(row, m.scale.cells));
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 图例：逐枚「形 ＋ 字」（形是那一段里真的出现过的字形；字是这一档叫什么）。 */
+function legendHtml(m) {
+    const parts = ['<div class="' + ganttTimelineSlot('legend') + '">'];
+    for (const item of m.legend) {
+        parts.push('<span class="' + ganttTimelineSlot('legend-item') + '"><i class="' + ganttTimelineSlot('swatch')
+            + ' ' + ganttTimelineStateClass(item.state) + '">' + esc(item.mark) + '</i>'
+            + '<span class="' + ganttTimelineSlot('legend-word') + '">' + esc(item.word) + '</span></span>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 形态 C 的骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+function renderFormC(m) {
+    return headHtml(m) + axisHtml(m) + bodyHtml(m)
+        + (m.legend.length > 0 ? legendHtml(m) : '')
+        + '<p class="' + ganttTimelineSlot('note') + '">' + esc(m.note) + '</p>';
+}
+/** 形态 → 骨架（本件只有一格）。 */
+const SKELETONS = {
+    C: renderFormC,
+};
+/** 渲染甘特时间线（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderGanttTimeline(input) {
+    const m = normalizeGanttTimeline(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + GANTT_TIMELINE_CLASS + ' is-' + m.form + extra + '">' + SKELETONS[m.form](m) + '</div>';
+}

package/dist/components/gantt-timeline/render.js.map

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

package/dist/components/gantt-timeline/scale.d.ts

@@ -0,0 +1,50 @@
+/** 轴域：这一张图的格宽、格数、时间跨度（三者只在这里成组出现）。 */
+export interface GanttTimelineScale {
+    /** 一格几分钟。 */
+    readonly cellMinutes: number;
+    /** 时间跨度（分钟；**恒是 `cellMinutes` 的整数倍**）。 */
+    readonly spanMinutes: number;
+    /** 格数（＝ `spanMinutes ÷ cellMinutes`）。 */
+    readonly cells: number;
+}
+/** 一段在格网上的落位（`grid-column: column / span span`）。 */
+export interface GanttTimelineCellSpan {
+    readonly column: number;
+    readonly span: number;
+}
+/** 一个分钟数落不落在格线上。 */
+export declare function isOnGrid(minute: number, cellMinutes: number): boolean;
+/** 一个时长是几格（**至少一格**：小于一格的段画不出来，调用方该把格调细）。 */
+export declare function cellCount(minutes: number, cellMinutes: number): number;
+/** 分钟数 → 第几格（1 起，与 CSS 的 `grid-column` 同口径）。 */
+export declare function cellColumn(minute: number, scale: GanttTimelineScale): number;
+/** **本件唯一的落位函数**：一段（起 ＋ 时长）→ 占哪几格；`minCells` 兜住"至少要占一格"。 */
+export declare function cellSpan(from: number, minutes: number, scale: GanttTimelineScale, minCells?: number): GanttTimelineCellSpan;
+/** 里程碑的落位：元素**从落点铺到轨迹末端**（文字长在点的右边），落点落在右半区时反过来
+ *  （从第 1 格铺到落点**前**那一格 ＋ 内容右对齐 ⇒ 文字长在点的左边）。
+ *  这样那枚 `◆` 的**左缘／右缘恒压在格线上**（读者按刻度数得对），文字又总有半条轨迹可换行。
+ *  落点正好在跨度末端时它落在第 `格数 + 1` 条格线上（那正是轨迹的右缘），故这一步**不夹到格数**。 */
+export declare function milestoneSpan(at: number, scale: GanttTimelineScale): {
+    readonly column: number;
+    readonly span: number;
+    readonly atEnd: boolean;
+};
+/** 一个分钟数在轨迹里占的百分比（0…1，四位小数）：「现在」游标用它定位。 */
+export declare function atRatio(at: number, scale: GanttTimelineScale): number;
+/** 格数 → 轴域（**跨度先补满整格**，再夹进上下限：少到 6 格以下刻度字比格还密）。 */
+export declare function scaleOf(spanMinutes: number, cellMinutes: number): GanttTimelineScale;
+/** 每几格写一枚刻度数字（**算出来的**：枚数不超过 `GANTT_TIMELINE_MAX_TICK_LABELS`）。 */
+export declare function tickStep(cells: number): number;
+/** 一枚刻度：落在第几格（0 起）＋ 写什么 ＋ 要不要右对齐（最后一格上的字往左长，免得跑出刻度区）。 */
+export interface GanttTimelineTick {
+    readonly index: number;
+    readonly text: string;
+    readonly atEnd: boolean;
+}
+/** 分钟数 → 给人看的字（整数不带小数点）。 */
+export declare function minuteText(value: number): string;
+/** 刻度逐枚（**唯一的刻度算法**）：`labels` 给了就整枚替换文字，枚数不符由 `model.ts` 拦。 */
+export declare function ticksOf(scale: GanttTimelineScale, labels?: readonly string[]): readonly GanttTimelineTick[];
+/** 刻度枚数（`model.ts` 拿它对 `tickText` 的枚数，判据拿它断"刻度只有一处算"）。 */
+export declare function tickCount(cells: number): number;
+//# sourceMappingURL=scale.d.ts.map

package/dist/components/gantt-timeline/scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../../src/components/gantt-timeline/scale.ts"],"names":[],"mappings":"AAmBA,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkBD,oBAAoB;AACpB,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE5E;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAC/E,QAAQ,SAAI,GAAG,qBAAqB,CAIrC;AAED;;;4DAG4D;AAC5D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GACnE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAM1E;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAErE;AAED,mDAAmD;AACnD,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAIpF;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAcD,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAY3G;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/components/gantt-timeline/scale.js

@@ -0,0 +1,108 @@
+/** gantt-timeline · **分钟 → 格**（本件第三份源码件：`model.ts` 用它把读数落成格，`render.ts` 只读结果）。
+ *
+ *  为什么有这一件：坐标只有一处算。**段的起止、空档块的起止、里程碑落哪一格、游标画在哪个百分比、
+ *  刻度数字写在哪几格**——全部从这里的同一个轴域（`scale`）出来。两处各写一套必然走散，
+ *  而甘特这种图一旦格线对不上，「读者按刻度数条」就会数错。
+ *
+ *  三条口径：
+ *   1. **格是这一张图的精度**：所有落在格线上的读数（段／里程碑）必须是 `cellMinutes` 的整数倍，
+ *      不是整数倍的由 `model.ts` 当场拒收——本件不许"描到最近的格线"，那是把读数画歪。
+ *   2. **格数由轴域算**（时间跨度 ÷ 每格分钟数），不由调用方数；刻度数字也只写其中
+ *      `GANTT_TIMELINE_MAX_TICK_LABELS` 枚以内，其余格子只有格线。
+ *   3. 本件不认形态、不碰标记：输入是数与轴域，输出还是数（或数拼成的字）。
+ */
+import { GANTT_TIMELINE_MAX_CELLS, GANTT_TIMELINE_MAX_TICK_LABELS, GANTT_TIMELINE_MIN_CELLS, } from './attrs.js';
+/** 判「落在格线上」的容差：**相对格号**（绝对容差两头都不对，见下）。
+ *
+ *  为什么不能用绝对容差：判的是「格号是不是整数」，而绝对容差（原先取 1e-6）在**格号**上等于是
+ *  「小于 1e-6 格都当整格」——`minutes: 1e-9`（÷5 分钟 ＝ 2e-10 格）、`minutes: 1e-6`、`from: 1e-7`
+ *  全部当成整格收下，而按 `span` 画出来是整一格：**画的宽度与读数不符**（读数还照写 `占用 1e-9 分`）。
+ *  改成相对量级：容差 ＝ 格号 × 1e-12 ⇒ 上面三档都拒（差 2e-10／2e-7／2e-8 格），
+ *  而合法值的浮点噪声收得住（`0.3 ÷ 0.1` 差 4e-16 格；1e7 格那一档的噪声约 1.8e-9 格，
+ *  乘上量级后容差 1e-5 格）。 */
+const GRID_REL = 1e-12;
+/** 补满整格时的容差（时间跨度那一头，绝对口径）：18.0000000001 格不该被抬成 19 格。 */
+const SPAN_EPS = 1e-6;
+/** 百分比保留几位（行内样式里不许出现 0.30000000000000004）。 */
+const round4 = (v) => Math.round(v * 1e4) / 1e4;
+const clamp = (v, lo, hi) => (v < lo ? lo : (v > hi ? hi : v));
+/** 一个分钟数落不落在格线上。 */
+export function isOnGrid(minute, cellMinutes) {
+    const k = minute / cellMinutes;
+    return Math.abs(k - Math.round(k)) <= GRID_REL * Math.max(1, Math.abs(k));
+}
+/** 一个时长是几格（**至少一格**：小于一格的段画不出来，调用方该把格调细）。 */
+export function cellCount(minutes, cellMinutes) {
+    return Math.max(1, Math.round(minutes / cellMinutes));
+}
+/** 分钟数 → 第几格（1 起，与 CSS 的 `grid-column` 同口径）。 */
+export function cellColumn(minute, scale) {
+    return clamp(Math.round(minute / scale.cellMinutes) + 1, 1, scale.cells);
+}
+/** **本件唯一的落位函数**：一段（起 ＋ 时长）→ 占哪几格；`minCells` 兜住"至少要占一格"。 */
+export function cellSpan(from, minutes, scale, minCells = 1) {
+    const column = cellColumn(from, scale);
+    const span = Math.max(minCells, cellCount(minutes, scale.cellMinutes), 1);
+    return { column, span: Math.max(1, Math.min(span, scale.cells - column + 1)) };
+}
+/** 里程碑的落位：元素**从落点铺到轨迹末端**（文字长在点的右边），落点落在右半区时反过来
+ *  （从第 1 格铺到落点**前**那一格 ＋ 内容右对齐 ⇒ 文字长在点的左边）。
+ *  这样那枚 `◆` 的**左缘／右缘恒压在格线上**（读者按刻度数得对），文字又总有半条轨迹可换行。
+ *  落点正好在跨度末端时它落在第 `格数 + 1` 条格线上（那正是轨迹的右缘），故这一步**不夹到格数**。 */
+export function milestoneSpan(at, scale) {
+    const raw = Math.round(at / scale.cellMinutes) + 1;
+    const atEnd = raw > Math.ceil(scale.cells / 2);
+    if (atEnd)
+        return { column: 1, span: clamp(raw - 1, 1, scale.cells), atEnd };
+    const column = clamp(raw, 1, scale.cells);
+    return { column, span: Math.max(1, scale.cells - column + 1), atEnd };
+}
+/** 一个分钟数在轨迹里占的百分比（0…1，四位小数）：「现在」游标用它定位。 */
+export function atRatio(at, scale) {
+    return round4(clamp(at / scale.spanMinutes, 0, 1));
+}
+/** 格数 → 轴域（**跨度先补满整格**，再夹进上下限：少到 6 格以下刻度字比格还密）。 */
+export function scaleOf(spanMinutes, cellMinutes) {
+    const spanCells = Math.max(1, Math.ceil(spanMinutes / cellMinutes - SPAN_EPS));
+    const cells = clamp(spanCells, GANTT_TIMELINE_MIN_CELLS, GANTT_TIMELINE_MAX_CELLS);
+    return { cellMinutes, spanMinutes: round4(cells * cellMinutes), cells };
+}
+/** 每几格写一枚刻度数字（**算出来的**：枚数不超过 `GANTT_TIMELINE_MAX_TICK_LABELS`）。 */
+export function tickStep(cells) {
+    return Math.max(1, Math.ceil(cells / GANTT_TIMELINE_MAX_TICK_LABELS));
+}
+/** 千分位（`1440` → `1,440`；负号留在最前）。 */
+function groupInt(s) {
+    const neg = s.startsWith('-');
+    const body = neg ? s.slice(1) : s;
+    let out = '';
+    for (let i = 0; i < body.length; i += 1) {
+        if (i > 0 && (body.length - i) % 3 === 0)
+            out += ',';
+        out += body[i];
+    }
+    return (neg ? '-' : '') + out;
+}
+/** 分钟数 → 给人看的字（整数不带小数点）。 */
+export function minuteText(value) {
+    const n = Math.round(value * 1000) / 1000;
+    return Number.isInteger(n) ? groupInt(String(n)) : groupInt(String(n).replace(/\.?0+$/, ''));
+}
+/** 刻度逐枚（**唯一的刻度算法**）：`labels` 给了就整枚替换文字，枚数不符由 `model.ts` 拦。 */
+export function ticksOf(scale, labels) {
+    const step = tickStep(scale.cells);
+    const out = [];
+    for (let i = 0; i < scale.cells; i += step) {
+        const k = out.length;
+        out.push({
+            index: i,
+            text: labels === undefined ? minuteText(i * scale.cellMinutes) : labels[k],
+            atEnd: i === scale.cells - 1,
+        });
+    }
+    return out;
+}
+/** 刻度枚数（`model.ts` 拿它对 `tickText` 的枚数，判据拿它断"刻度只有一处算"）。 */
+export function tickCount(cells) {
+    return Math.ceil(cells / tickStep(cells));
+}

package/dist/components/gantt-timeline/scale.js.map

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

package/dist/components/gantt-timeline/style-marks.d.ts

@@ -0,0 +1,5 @@
+/** 轨迹里那几档读数的样式段（由 `style.ts` 汇总进本件的样式段，前缀与 scope 一起透传）。 */
+export declare function ganttTimelineMarksCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style-marks.d.ts.map

package/dist/components/gantt-timeline/style-marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-marks.d.ts","sourceRoot":"","sources":["../../../src/components/gantt-timeline/style-marks.ts"],"names":[],"mappings":"AAgBA,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAwLlF"}