@bicharts/chart-host 0.5.86 → 0.5.87

package/dist/types/sourceDateFormat.d.ts

@@ -0,0 +1,30 @@
+/** Which vocabulary a source format string is written in. See the header note - this is stated
+ *  by the host that owns the format, never inferred from the string. */
+export type SourceFormatDialect = "excel" | "dotnet";
+/** A host's per-column source formats. The dialect is carried WITH the map rather than passed
+ *  beside it, so a caller cannot supply one without the other. */
+export interface SourceFormats {
+    dialect: SourceFormatDialect;
+    /** Keyed by column name, which is the key the payload's columns already carry. Absent or
+     *  blank for a column with no source format - a computed column, a CSV, a text date whose
+     *  own text IS its formatting. */
+    byColumn: Record<string, string>;
+}
+export interface SourceDateOptions {
+    /** The source's own format string for this column, if it has one. */
+    format?: string | null;
+    /** Which vocabulary `format` is written in. Ignored when `format` is absent. */
+    dialect?: SourceFormatDialect;
+    /** BCP-47 tag, for month and weekday names and for the locale fallback. */
+    culture?: string;
+}
+/**
+ * Render a temporal payload value for a reader, or NULL when the value is not a date at all.
+ *
+ * Null rather than a best-effort string, so a caller can fall through to whatever it did before
+ * without this file having an opinion about non-dates. Accepts a `Date` (what a host holds before
+ * the payload is built) and an ISO string (what the payload carries after it).
+ */
+export declare function formatSourceDate(raw: any, opts?: SourceDateOptions): string | null;
+/** Convenience for a caller holding a `SourceFormats` map and a column name. */
+export declare function formatSourceDateFor(raw: any, columnName: string, formats: SourceFormats | null | undefined, culture?: string): string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.5.86",
+  "version": "0.5.87",
   "description": "Run a BIC-generated D3 chart in any web host: compiles the generated render() function, applies the shared option defaults, resolves mark clicks (through tooltip overlays), owns the selection affordance, and translates row indices between cross-filtered charts. The same contract the BIC Power BI visual implements, minus Power BI. React bindings at @bicharts/chart-host/react.",
   "license": "Apache-2.0",
   "type": "module",