@stisocial/ui 0.2.0 → 0.3.0

package/dist/agency/BriefForm/BriefForm.js

@@ -0,0 +1,247 @@
+"use client";
+import { useMessages } from "../../provider/UIProvider.js";
+import { Button } from "../../components/Button/Button.js";
+import { Fieldset } from "../../components/Fieldset/Fieldset.js";
+import { TextField } from "../../components/TextField/TextField.js";
+import { TextArea } from "../../components/TextArea/TextArea.js";
+import { Alert } from "../../components/Alert/Alert.js";
+import { Checkbox } from "../../components/Checkbox/Checkbox.js";
+import { CheckboxGroup } from "../../components/CheckboxGroup/CheckboxGroup.js";
+import { Select } from "../../components/Select/Select.js";
+import { NumberField } from "../../components/NumberField/NumberField.js";
+import { DateRangePicker } from "../../components/DateRangePicker/DateRangePicker.js";
+import { Form } from "../../components/Form/Form.js";
+import { TagInput } from "../../components/TagInput/TagInput.js";
+import { Radio, RadioGroup } from "../../components/RadioGroup/RadioGroup.js";
+import { PLATFORMS } from "../_shared/platforms.js";
+import { cx } from "../_shared/Preview.js";
+import { PLATFORM_NAMES } from "../PlatformCharacterLimit/PlatformCharacterLimit.js";
+import BriefForm_module_default from "./BriefForm.module.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+// src/agency/BriefForm/BriefForm.tsx
+const OBJECTIVES = [
+	"awareness",
+	"engagement",
+	"traffic",
+	"leads",
+	"sales"
+];
+/**
+* Kampanya brifi formu: temel bilgiler (ad, müşteri, tarih aralığı, bütçe), amaç, hedef kitle ve
+* ana mesaj, kanallar ve teslimatlar, referanslar ve notlar. Zorunlu alanlar gönderimde denetlenir
+* ve hata özeti en üste gelir; gönderim başarılı olunca onay yazılır, form kilitlenir.
+*/
+function BriefForm({ clients, defaultValues, onSubmit, onSaveDraft, currency = "TRY", className, id }) {
+	const t = useMessages();
+	const [v, setV] = useState({
+		name: "",
+		clientId: null,
+		objective: null,
+		audience: "",
+		message: "",
+		channels: [],
+		deliverables: [],
+		budget: null,
+		dates: null,
+		references: "",
+		notes: "",
+		...defaultValues
+	});
+	const [pending, setPending] = useState(false);
+	const [error, setError] = useState(null);
+	const [sent, setSent] = useState(false);
+	const [confirmed, setConfirmed] = useState(false);
+	const set = (k, value) => setV((prev) => ({
+		...prev,
+		[k]: value
+	}));
+	const objectiveText = {
+		awareness: [t.agencyBriefAwareness, t.agencyBriefAwarenessHint],
+		engagement: [t.agencyBriefEngagement, t.agencyBriefEngagementHint],
+		traffic: [t.agencyBriefTraffic, t.agencyBriefTrafficHint],
+		leads: [t.agencyBriefLeads, t.agencyBriefLeadsHint],
+		sales: [t.agencyBriefSales, t.agencyBriefSalesHint]
+	};
+	if (sent) return /* @__PURE__ */ jsx("div", {
+		id,
+		className: cx(BriefForm_module_default.root, className),
+		children: /* @__PURE__ */ jsx(Alert, {
+			tone: "success",
+			title: t.agencyBriefSent,
+			children: t.agencyBriefSentBody
+		})
+	});
+	return /* @__PURE__ */ jsxs(Form, {
+		id,
+		className: cx(BriefForm_module_default.root, className),
+		errorSummary: "focus",
+		isPending: pending,
+		onSubmit: async () => {
+			setPending(true);
+			setError(null);
+			try {
+				const result = await onSubmit(v);
+				if (typeof result === "string" && result) setError(result);
+				else setSent(true);
+			} catch {
+				setError(t.agencyBriefFailed);
+			} finally {
+				setPending(false);
+			}
+		},
+		children: [
+			error ? /* @__PURE__ */ jsx(Alert, {
+				tone: "danger",
+				title: error
+			}) : null,
+			/* @__PURE__ */ jsx(Fieldset, {
+				legend: t.agencyBriefBasics,
+				children: /* @__PURE__ */ jsxs("div", {
+					className: BriefForm_module_default.grid,
+					children: [
+						/* @__PURE__ */ jsx(TextField, {
+							label: t.agencyBriefName,
+							name: "name",
+							value: v.name,
+							onChange: (x) => set("name", x),
+							isRequired: true,
+							maxLength: 120
+						}),
+						/* @__PURE__ */ jsx(Select, {
+							label: t.agencyBriefClient,
+							name: "client",
+							items: clients.map((c) => ({
+								id: c.id,
+								label: c.name
+							})),
+							value: v.clientId,
+							onChange: (x) => set("clientId", x),
+							placeholder: t.agencyBriefClientPlaceholder,
+							isRequired: true
+						}),
+						/* @__PURE__ */ jsx(DateRangePicker, {
+							label: t.agencyBriefDates,
+							value: v.dates,
+							onChange: (x) => set("dates", x),
+							startName: "start",
+							endName: "end",
+							isRequired: true
+						}),
+						/* @__PURE__ */ jsx(NumberField, {
+							label: t.agencyBriefBudget,
+							name: "budget",
+							value: v.budget ?? void 0,
+							onChange: (x) => set("budget", Number.isFinite(x) ? x : null),
+							minValue: 0,
+							step: 1e3,
+							formatOptions: {
+								style: "currency",
+								currency,
+								maximumFractionDigits: 0
+							},
+							description: t.agencyBriefBudgetHint
+						})
+					]
+				})
+			}),
+			/* @__PURE__ */ jsxs(Fieldset, {
+				legend: t.agencyBriefGoal,
+				children: [
+					/* @__PURE__ */ jsx(RadioGroup, {
+						label: t.agencyBriefObjective,
+						name: "objective",
+						value: v.objective,
+						onChange: (x) => set("objective", x),
+						isRequired: true,
+						children: OBJECTIVES.map((o) => /* @__PURE__ */ jsx(Radio, {
+							value: o,
+							description: objectiveText[o][1],
+							children: objectiveText[o][0]
+						}, o))
+					}),
+					/* @__PURE__ */ jsx(TextArea, {
+						label: t.agencyBriefAudience,
+						name: "audience",
+						description: t.agencyBriefAudienceHint,
+						value: v.audience,
+						onChange: (x) => set("audience", x),
+						isRequired: true,
+						minRows: 3
+					}),
+					/* @__PURE__ */ jsx(TextArea, {
+						label: t.agencyBriefMessage,
+						name: "message",
+						description: t.agencyBriefMessageHint,
+						value: v.message,
+						onChange: (x) => set("message", x),
+						isRequired: true,
+						minRows: 2,
+						maxLength: 280
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs(Fieldset, {
+				legend: t.agencyBriefScope,
+				children: [/* @__PURE__ */ jsx(CheckboxGroup, {
+					label: t.agencyBriefChannels,
+					name: "channels",
+					orientation: "horizontal",
+					value: v.channels,
+					onChange: (x) => set("channels", x),
+					isRequired: true,
+					children: PLATFORMS.map((p) => /* @__PURE__ */ jsx(Checkbox, {
+						value: p,
+						children: PLATFORM_NAMES[p]
+					}, p))
+				}), /* @__PURE__ */ jsx(TagInput, {
+					label: t.agencyBriefDeliverables,
+					description: t.agencyBriefDeliverablesHint,
+					value: v.deliverables,
+					onChange: (x) => set("deliverables", x)
+				})]
+			}),
+			/* @__PURE__ */ jsxs(Fieldset, {
+				legend: t.agencyBriefExtra,
+				children: [
+					/* @__PURE__ */ jsx(TextArea, {
+						label: t.agencyBriefReferences,
+						name: "references",
+						description: t.agencyBriefReferencesHint,
+						value: v.references,
+						onChange: (x) => set("references", x),
+						minRows: 2
+					}),
+					/* @__PURE__ */ jsx(TextArea, {
+						label: t.agencyBriefNotes,
+						name: "notes",
+						value: v.notes,
+						onChange: (x) => set("notes", x),
+						minRows: 2
+					}),
+					/* @__PURE__ */ jsx(Checkbox, {
+						isSelected: confirmed,
+						onChange: setConfirmed,
+						isRequired: true,
+						children: t.agencyBriefConfirm
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: BriefForm_module_default.actions,
+				children: [onSaveDraft ? /* @__PURE__ */ jsx(Button, {
+					variant: "secondary",
+					isDisabled: pending,
+					onPress: () => onSaveDraft(v),
+					children: t.agencyScheduleDraft
+				}) : null, /* @__PURE__ */ jsx(Button, {
+					type: "submit",
+					variant: "primary",
+					isPending: pending,
+					children: t.agencyBriefSubmit
+				})]
+			})
+		]
+	});
+}
+export { BriefForm };

package/dist/agency/BriefForm/BriefForm.module.js

@@ -0,0 +1,8 @@
+import './BriefForm.css';
+// src/agency/BriefForm/BriefForm.module.css
+var BriefForm_module_default = {
+	"root": "sti-BriefForm-root-19f79",
+	"grid": "sti-BriefForm-grid-eb147",
+	"actions": "sti-BriefForm-actions-6ae34"
+};
+export { BriefForm_module_default as default };

package/dist/agency/BriefForm/index.d.ts

@@ -0,0 +1,2 @@
+import { BriefForm, BriefFormProps, BriefObjective, BriefValues } from "./BriefForm.js";
+export { BriefForm, BriefFormProps, BriefObjective, BriefValues };

package/dist/agency/BudgetTracker/BudgetTracker.css

@@ -0,0 +1,159 @@
+@layer sti.reset, sti.tokens, sti.base, sti.components, sti.variants, sti.utilities;
+@layer sti.components {
+  .sti-BudgetTracker-root-d12ae {
+    gap: var(--sti-space-3);
+    box-sizing: border-box;
+    inline-size: 100%;
+    min-inline-size: 0;
+    padding: var(--sti-space-5);
+    border: var(--sti-border-width) solid var(--sti-border-subtle);
+    border-radius: var(--sti-radius-lg);
+    background: var(--sti-bg-surface);
+    color: var(--sti-fg);
+    font-family: var(--sti-font-text);
+    display: grid;
+  }
+
+  .sti-BudgetTracker-summary-5626d {
+    align-items: flex-end;
+    gap: var(--sti-space-3) var(--sti-space-6);
+    flex-wrap: wrap;
+    display: flex;
+  }
+
+  .sti-BudgetTracker-figure-2e55f {
+    display: grid;
+  }
+
+  .sti-BudgetTracker-figureLabel-a3bdc {
+    color: var(--sti-fg-muted);
+    font-size: var(--sti-font-size-xs);
+  }
+
+  .sti-BudgetTracker-figureValue-5898f {
+    font-family: var(--sti-font-numeric);
+    font-size: var(--sti-font-size-xl);
+    font-weight: var(--sti-font-weight-semibold);
+    font-variant-numeric: tabular-nums;
+  }
+
+  .sti-BudgetTracker-status-c0cd9 {
+    padding: var(--sti-space-1) var(--sti-space-3);
+    border-radius: var(--sti-radius-pill);
+    background: var(--sti-bg-subtle);
+    color: var(--sti-fg-muted);
+    font-size: var(--sti-font-size-sm);
+    font-weight: var(--sti-font-weight-semibold);
+    margin-inline-start: auto;
+  }
+
+  .sti-BudgetTracker-status-c0cd9[data-tone="success"] {
+    background: var(--sti-bg-success-subtle);
+    color: var(--sti-fg-success-strong);
+  }
+
+  .sti-BudgetTracker-status-c0cd9[data-tone="warning"] {
+    background: var(--sti-bg-warning-subtle);
+    color: var(--sti-fg-warning-strong);
+  }
+
+  .sti-BudgetTracker-status-c0cd9[data-tone="danger"] {
+    background: var(--sti-bg-danger-subtle);
+    color: var(--sti-fg-danger-strong);
+  }
+
+  .sti-BudgetTracker-track-c3c1e, .sti-BudgetTracker-lineTrack-a8e20 {
+    --sti-budget-fill: 0%;
+    --sti-budget-marker: 0%;
+    border-radius: var(--sti-radius-pill);
+    background: var(--sti-bg-subtle);
+    display: block;
+    position: relative;
+    overflow: visible;
+  }
+
+  .sti-BudgetTracker-track-c3c1e {
+    block-size: var(--sti-space-3);
+  }
+
+  .sti-BudgetTracker-lineTrack-a8e20 {
+    block-size: var(--sti-space-1);
+    grid-column: 1 / -1;
+    overflow: hidden;
+  }
+
+  .sti-BudgetTracker-fill-9ac03 {
+    inline-size: var(--sti-budget-fill);
+    border-radius: inherit;
+    background: var(--sti-fill-accent);
+    block-size: 100%;
+    display: block;
+  }
+
+  :is(.sti-BudgetTracker-track-c3c1e, .sti-BudgetTracker-lineTrack-a8e20):not([data-placed]) .sti-BudgetTracker-fill-9ac03, .sti-BudgetTracker-track-c3c1e:not([data-placed]) .sti-BudgetTracker-marker-71b09 {
+    visibility: hidden;
+  }
+
+  .sti-BudgetTracker-track-c3c1e[data-tone="warning"] .sti-BudgetTracker-fill-9ac03 {
+    background: var(--sti-fill-warning);
+  }
+
+  .sti-BudgetTracker-track-c3c1e[data-tone="danger"] .sti-BudgetTracker-fill-9ac03, .sti-BudgetTracker-line-32a4d[data-over] .sti-BudgetTracker-fill-9ac03 {
+    background: var(--sti-fill-danger);
+  }
+
+  .sti-BudgetTracker-marker-71b09 {
+    inset-block: calc(var(--sti-space-1) * -1);
+    inline-size: var(--sti-border-width-strong);
+    background: var(--sti-fg);
+    position: absolute;
+    inset-inline-start: var(--sti-budget-marker);
+  }
+
+  .sti-BudgetTracker-note-f7784 {
+    color: var(--sti-fg-muted);
+    font-size: var(--sti-font-size-xs);
+    line-height: var(--sti-line-height-xs);
+    margin: 0;
+  }
+
+  .sti-BudgetTracker-lines-a9b64 {
+    gap: var(--sti-space-3);
+    margin: var(--sti-space-2) 0 0;
+    padding: var(--sti-space-3) 0 0;
+    border-block-start: var(--sti-border-width) solid var(--sti-border-subtle);
+    list-style: none;
+    display: grid;
+  }
+
+  .sti-BudgetTracker-line-32a4d {
+    gap: var(--sti-space-1) var(--sti-space-3);
+    font-size: var(--sti-font-size-sm);
+    grid-template-columns: minmax(0, 1fr) auto;
+    display: grid;
+  }
+
+  .sti-BudgetTracker-lineValue-7f108 {
+    color: var(--sti-fg-muted);
+    font-variant-numeric: tabular-nums;
+  }
+
+  .sti-BudgetTracker-lineOver-34731 {
+    color: var(--sti-fg-danger-strong);
+    font-weight: var(--sti-font-weight-semibold);
+  }
+
+  @media (forced-colors: active) {
+    .sti-BudgetTracker-track-c3c1e, .sti-BudgetTracker-lineTrack-a8e20 {
+      outline: var(--sti-border-width) solid CanvasText;
+    }
+
+    .sti-BudgetTracker-fill-9ac03 {
+      background: highlight;
+    }
+
+    .sti-BudgetTracker-marker-71b09 {
+      background: canvastext;
+    }
+  }
+}

package/dist/agency/BudgetTracker/BudgetTracker.d.ts

@@ -0,0 +1,29 @@
+export interface BudgetLine {
+  id: string;
+  /** Kalem ("Meta reklamları", "Prodüksiyon"). */
+  name: string;
+  /** Ayrılan tutar. */
+  allocated: number;
+  spent: number;
+}
+export interface BudgetTrackerProps {
+  /** Toplam bütçe. */
+  total: number;
+  /** Toplam harcanan; verilmezse kalemlerin toplamı. */
+  spent?: number;
+  start: Date | number | string;
+  end: Date | number | string;
+  now?: Date | number | string;
+  lines?: readonly BudgetLine[];
+  currency?: string;
+  /** Bölgenin adı; verilmezse "Bütçe". */
+  label?: string;
+  className?: string;
+  id?: string;
+}
+/**
+ * Bütçe takibi: harcanan, kalan ve toplam; dönemin geçen kısmını gösteren işaretli çubuk;
+ * harcama hızı durumu (planlı, hızlı, yavaş, tükendi) ve dönem sonu tahmini; kalem kalem dağılım.
+ * Durum renkle birlikte metinle bildirilir.
+ */
+export declare function BudgetTracker({ total, spent, start, end, now, lines, currency, label, className, id }: BudgetTrackerProps): import("react").JSX.Element;

package/dist/agency/BudgetTracker/BudgetTracker.js

@@ -0,0 +1,147 @@
+"use client";
+import { useFormatter, useMessages } from "../../provider/UIProvider.js";
+import { template } from "../../text/text.js";
+import { cx } from "../_shared/Preview.js";
+import BudgetTracker_module_default from "./BudgetTracker.module.js";
+import { budgetPace } from "./budgetPace.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback } from "react";
+// src/agency/BudgetTracker/BudgetTracker.tsx
+const TONE = {
+	"on-track": "success",
+	under: "warning",
+	over: "danger",
+	exhausted: "danger",
+	"not-started": "neutral",
+	ended: "neutral"
+};
+/**
+* Bütçe takibi: harcanan, kalan ve toplam; dönemin geçen kısmını gösteren işaretli çubuk;
+* harcama hızı durumu (planlı, hızlı, yavaş, tükendi) ve dönem sonu tahmini; kalem kalem dağılım.
+* Durum renkle birlikte metinle bildirilir.
+*/
+function BudgetTracker({ total, spent, start, end, now, lines = [], currency = "TRY", label, className, id }) {
+	const t = useMessages();
+	const f = useFormatter();
+	const used = spent ?? lines.reduce((sum, l) => sum + l.spent, 0);
+	const pace = budgetPace(total, used, start, end, now ?? Date.now());
+	const money = (v) => f.currency(v, {
+		currency,
+		whole: true
+	});
+	const statusText = {
+		"on-track": t.agencyBudgetOnTrack,
+		under: t.agencyBudgetUnder,
+		over: t.agencyBudgetOver,
+		exhausted: t.agencyBudgetExhausted,
+		"not-started": t.agencyBudgetNotStarted,
+		ended: t.agencyBudgetEnded
+	};
+	const bar = useCallback((fill, marker) => (el) => {
+		if (!el) return;
+		el.style.setProperty("--sti-budget-fill", `${Math.min(100, fill * 100)}%`);
+		if (marker !== void 0) el.style.setProperty("--sti-budget-marker", `${marker * 100}%`);
+		el.dataset.placed = "";
+	}, []);
+	return /* @__PURE__ */ jsxs("section", {
+		id,
+		className: cx(BudgetTracker_module_default.root, className),
+		"aria-label": label ?? t.agencyBudget,
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: BudgetTracker_module_default.summary,
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: BudgetTracker_module_default.figure,
+						children: [/* @__PURE__ */ jsx("span", {
+							className: BudgetTracker_module_default.figureLabel,
+							children: t.agencyBudgetSpent
+						}), /* @__PURE__ */ jsx("span", {
+							className: BudgetTracker_module_default.figureValue,
+							children: money(used)
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: BudgetTracker_module_default.figure,
+						children: [/* @__PURE__ */ jsx("span", {
+							className: BudgetTracker_module_default.figureLabel,
+							children: t.agencyBudgetRemaining
+						}), /* @__PURE__ */ jsx("span", {
+							className: BudgetTracker_module_default.figureValue,
+							children: money(pace.remaining)
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: BudgetTracker_module_default.figure,
+						children: [/* @__PURE__ */ jsx("span", {
+							className: BudgetTracker_module_default.figureLabel,
+							children: t.agencyBudgetTotal
+						}), /* @__PURE__ */ jsx("span", {
+							className: BudgetTracker_module_default.figureValue,
+							children: money(total)
+						})]
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: BudgetTracker_module_default.status,
+						"data-tone": TONE[pace.status],
+						children: statusText[pace.status]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				ref: bar(pace.spentRatio, pace.elapsed),
+				className: BudgetTracker_module_default.track,
+				role: "img",
+				"aria-label": template(t.agencyBudgetBar, {
+					spent: f.percent(pace.spentRatio),
+					elapsed: f.percent(pace.elapsed)
+				}),
+				"data-tone": TONE[pace.status],
+				children: [/* @__PURE__ */ jsx("span", { className: BudgetTracker_module_default.fill }), /* @__PURE__ */ jsx("span", { className: BudgetTracker_module_default.marker })]
+			}),
+			/* @__PURE__ */ jsxs("p", {
+				className: BudgetTracker_module_default.note,
+				children: [template(t.agencyBudgetPeriod, {
+					range: f.dateRange(new Date(start), new Date(end)),
+					elapsed: f.percent(pace.elapsed)
+				}), pace.status === "over" || pace.status === "under" || pace.status === "on-track" ? ` ${template(t.agencyBudgetProjection, { amount: money(pace.projected) })}` : ""]
+			}),
+			lines.length ? /* @__PURE__ */ jsx("ul", {
+				className: BudgetTracker_module_default.lines,
+				"aria-label": t.agencyBudgetLines,
+				children: lines.map((l) => {
+					const r = l.allocated > 0 ? l.spent / l.allocated : 0;
+					return /* @__PURE__ */ jsxs("li", {
+						className: BudgetTracker_module_default.line,
+						"data-over": r > 1 ? "" : void 0,
+						children: [
+							/* @__PURE__ */ jsx("span", {
+								className: BudgetTracker_module_default.lineName,
+								children: l.name
+							}),
+							/* @__PURE__ */ jsxs("span", {
+								className: BudgetTracker_module_default.lineValue,
+								children: [
+									money(l.spent),
+									" / ",
+									money(l.allocated),
+									r > 1 ? /* @__PURE__ */ jsx("span", {
+										className: BudgetTracker_module_default.lineOver,
+										children: ` · ${t.agencyBudgetLineOver}`
+									}) : null
+								]
+							}),
+							/* @__PURE__ */ jsx("span", {
+								ref: bar(r),
+								className: BudgetTracker_module_default.lineTrack,
+								"aria-hidden": "true",
+								children: /* @__PURE__ */ jsx("span", { className: BudgetTracker_module_default.fill })
+							})
+						]
+					}, l.id);
+				})
+			}) : null
+		]
+	});
+}
+export { BudgetTracker };

package/dist/agency/BudgetTracker/BudgetTracker.module.js

@@ -0,0 +1,20 @@
+import './BudgetTracker.css';
+// src/agency/BudgetTracker/BudgetTracker.module.css
+var BudgetTracker_module_default = {
+	"root": "sti-BudgetTracker-root-d12ae",
+	"summary": "sti-BudgetTracker-summary-5626d",
+	"figure": "sti-BudgetTracker-figure-2e55f",
+	"figureLabel": "sti-BudgetTracker-figureLabel-a3bdc",
+	"figureValue": "sti-BudgetTracker-figureValue-5898f",
+	"status": "sti-BudgetTracker-status-c0cd9",
+	"track": "sti-BudgetTracker-track-c3c1e",
+	"lineTrack": "sti-BudgetTracker-lineTrack-a8e20",
+	"fill": "sti-BudgetTracker-fill-9ac03",
+	"marker": "sti-BudgetTracker-marker-71b09",
+	"line": "sti-BudgetTracker-line-32a4d",
+	"note": "sti-BudgetTracker-note-f7784",
+	"lines": "sti-BudgetTracker-lines-a9b64",
+	"lineValue": "sti-BudgetTracker-lineValue-7f108",
+	"lineOver": "sti-BudgetTracker-lineOver-34731"
+};
+export { BudgetTracker_module_default as default };

package/dist/agency/BudgetTracker/budgetPace.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Bütçe harcama hızı (saf): dönemin geçen kısmına göre beklenen harcama, gerçekleşen harcamayla
+ * karşılaştırılır ve dönem sonu tahmini çıkarılır.
+ */
+export type PaceStatus = "on-track" | "over" | "under" | "exhausted" | "not-started" | "ended";
+export interface BudgetPace {
+  /** Dönemin geçen oranı (0–1). */
+  elapsed: number;
+  /** Harcanan oran (0–∞). */
+  spentRatio: number;
+  /** Bugüne kadar beklenen harcama. */
+  expected: number;
+  /** Bugünkü hızla dönem sonu tahmini. */
+  projected: number;
+  remaining: number;
+  status: PaceStatus;
+}
+/**
+ * `tolerance`: beklenenden bu orandan fazla sapma "hızlı" ya da "yavaş" sayılır (varsayılan %10).
+ */
+export declare function budgetPace(total: number, spent: number, start: Date | number | string, end: Date | number | string, now: Date | number | string, tolerance?: number): BudgetPace;

package/dist/agency/BudgetTracker/budgetPace.js

@@ -0,0 +1,30 @@
+// src/agency/BudgetTracker/budgetPace.ts
+/**
+* `tolerance`: beklenenden bu orandan fazla sapma "hızlı" ya da "yavaş" sayılır (varsayılan %10).
+*/
+function budgetPace(total, spent, start, end, now, tolerance = .1) {
+	const s = new Date(start).getTime();
+	const e = new Date(end).getTime();
+	const n = new Date(now).getTime();
+	const span = Math.max(1, e - s);
+	const elapsed = Math.min(1, Math.max(0, (n - s) / span));
+	const expected = total * elapsed;
+	const projected = elapsed > 0 ? spent / elapsed : spent;
+	const spentRatio = total > 0 ? spent / total : 0;
+	let status;
+	if (spent >= total && total > 0) status = "exhausted";
+	else if (n < s) status = "not-started";
+	else if (n >= e) status = "ended";
+	else if (spent > expected * (1 + tolerance)) status = "over";
+	else if (spent < expected * (1 - tolerance)) status = "under";
+	else status = "on-track";
+	return {
+		elapsed,
+		spentRatio,
+		expected,
+		projected,
+		remaining: Math.max(0, total - spent),
+		status
+	};
+}
+export { budgetPace };