@perses-dev/core 0.53.0-beta.0 → 0.53.0-beta.2

package/dist/model/datasource-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/model/datasource-api.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { DatasourceResource, DatasourceSelector, GlobalDatasourceResource } from './datasource';\n\n/**\n * Parameters for building a datasource proxy URL\n */\nexport interface BuildDatasourceProxyUrlParams {\n  project?: string;\n  dashboard?: string;\n  name: string;\n}\n\n/**\n * Function type for building datasource proxy URLs\n */\nexport type BuildDatasourceProxyUrlFunc = (params: BuildDatasourceProxyUrlParams) => string;\n\n/**\n * The external API contract for fetching datasource resources.\n * This defines the interface that must be implemented to provide\n * datasource functionality to the dashboard.\n */\nexport interface DatasourceApi {\n  /**\n   * Optional function to build proxy URLs for datasources\n   */\n  buildProxyUrl?: BuildDatasourceProxyUrlFunc;\n  /**\n   * Get a datasource resource for a specific project\n   */\n  getDatasource: (project: string, selector: DatasourceSelector) => Promise<DatasourceResource | undefined>;\n  /**\n   * Get a global datasource resource\n   */\n  getGlobalDatasource: (selector: DatasourceSelector) => Promise<GlobalDatasourceResource | undefined>;\n  /**\n   * List all datasources for a project, optionally filtered by plugin kind\n   */\n  listDatasources: (project: string, pluginKind?: string) => Promise<DatasourceResource[]>;\n  /**\n   * List all global datasources, optionally filtered by plugin kind\n   */\n  listGlobalDatasources: (pluginKind?: string) => Promise<GlobalDatasourceResource[]>;\n}\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAkBjC;;;;CAIC,GACD,WAqBC"}

package/dist/model/external-variable.d.ts

@@ -0,0 +1,29 @@
+import { VariableDefinition } from './variables';
+/**
+ * External variable definition that can be provided from an external source.
+ * Multiple external variable definitions can be provided to a dashboard, and
+ * the order of the sources is important as first one will take precedence on
+ * the following ones, in case they have same names.
+ */
+export interface ExternalVariableDefinition {
+    /**
+     * Source identifier for this set of external variables
+     */
+    source: string;
+    /**
+     * Optional tooltip information for the external variables
+     */
+    tooltip?: {
+        title?: string;
+        description?: string;
+    };
+    /**
+     * Optional link to edit these external variables
+     */
+    editLink?: string;
+    /**
+     * The variable definitions from this external source
+     */
+    definitions: VariableDefinition[];
+}
+//# sourceMappingURL=external-variable.d.ts.map

package/dist/model/external-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-variable.d.ts","sourceRoot":"","sources":["../../src/model/external-variable.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC"}

package/dist/model/external-variable.js

@@ -0,0 +1,20 @@
+// Copyright 2025 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/**
+ * External variable definition that can be provided from an external source.
+ * Multiple external variable definitions can be provided to a dashboard, and
+ * the order of the sources is important as first one will take precedence on
+ * the following ones, in case they have same names.
+ */ export { };
+
+//# sourceMappingURL=external-variable.js.map

package/dist/model/external-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/model/external-variable.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { VariableDefinition } from './variables';\n\n/**\n * External variable definition that can be provided from an external source.\n * Multiple external variable definitions can be provided to a dashboard, and\n * the order of the sources is important as first one will take precedence on\n * the following ones, in case they have same names.\n */\nexport interface ExternalVariableDefinition {\n  /**\n   * Source identifier for this set of external variables\n   */\n  source: string;\n  /**\n   * Optional tooltip information for the external variables\n   */\n  tooltip?: {\n    title?: string;\n    description?: string;\n  };\n  /**\n   * Optional link to edit these external variables\n   */\n  editLink?: string;\n  /**\n   * The variable definitions from this external source\n   */\n  definitions: VariableDefinition[];\n}\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAIjC;;;;;CAKC,GACD,WAoBC"}

package/dist/model/index.d.ts

@@ -1,9 +1,11 @@
 export * from './calculations';
 export * from './dashboard';
 export * from './datasource';
+export * from './datasource-api';
 export * from './definitions';
 export * from './display';
 export * from './ephemeraldashboard';
+export * from './external-variable';
 export * from './http';
 export * from './http-proxy';
 export * from './kind';
@@ -11,6 +13,7 @@ export * from './layout';
 export * from './legend';
 export * from './notice';
 export * from './otlp';
+export * from './panel-group';
 export * from './panels';
 export * from './project';
 export * from './query';

package/dist/model/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAaA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/model/index.js

@@ -1,4 +1,4 @@
-// Copyright 2023 The Perses Authors
+// Copyright 2025 The Perses Authors
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
@@ -13,9 +13,11 @@
 export * from './calculations';
 export * from './dashboard';
 export * from './datasource';
+export * from './datasource-api';
 export * from './definitions';
 export * from './display';
 export * from './ephemeraldashboard';
+export * from './external-variable';
 export * from './http';
 export * from './http-proxy';
 export * from './kind';
@@ -23,6 +25,7 @@ export * from './layout';
 export * from './legend';
 export * from './notice';
 export * from './otlp';
+export * from './panel-group';
 export * from './panels';
 export * from './project';
 export * from './query';

package/dist/model/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/model/index.ts"],"sourcesContent":["// Copyright 2023 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nexport * from './calculations';\nexport * from './dashboard';\nexport * from './datasource';\nexport * from './definitions';\nexport * from './display';\nexport * from './ephemeraldashboard';\nexport * from './http';\nexport * from './http-proxy';\nexport * from './kind';\nexport * from './layout';\nexport * from './legend';\nexport * from './notice';\nexport * from './otlp';\nexport * from './panels';\nexport * from './project';\nexport * from './query';\nexport * from './resource';\nexport * from './roles';\nexport * from './rolebindings';\nexport * from './secrets';\nexport * from './thresholds';\nexport * from './time';\nexport * from './time-series-data';\nexport * from './time-series-queries';\nexport * from './trace-data';\nexport * from './profile-data';\nexport * from './log-data';\nexport * from './transforms';\nexport * from './units';\nexport * from './user';\nexport * from './variables';\nexport * from './value-mapping';\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,cAAc,iBAAiB;AAC/B,cAAc,cAAc;AAC5B,cAAc,eAAe;AAC7B,cAAc,gBAAgB;AAC9B,cAAc,YAAY;AAC1B,cAAc,uBAAuB;AACrC,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,YAAY;AAC1B,cAAc,UAAU;AACxB,cAAc,aAAa;AAC3B,cAAc,UAAU;AACxB,cAAc,iBAAiB;AAC/B,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,SAAS;AACvB,cAAc,qBAAqB;AACnC,cAAc,wBAAwB;AACtC,cAAc,eAAe;AAC7B,cAAc,iBAAiB;AAC/B,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,cAAc;AAC5B,cAAc,kBAAkB"}
+{"version":3,"sources":["../../src/model/index.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nexport * from './calculations';\nexport * from './dashboard';\nexport * from './datasource';\nexport * from './datasource-api';\nexport * from './definitions';\nexport * from './display';\nexport * from './ephemeraldashboard';\nexport * from './external-variable';\nexport * from './http';\nexport * from './http-proxy';\nexport * from './kind';\nexport * from './layout';\nexport * from './legend';\nexport * from './notice';\nexport * from './otlp';\nexport * from './panel-group';\nexport * from './panels';\nexport * from './project';\nexport * from './query';\nexport * from './resource';\nexport * from './roles';\nexport * from './rolebindings';\nexport * from './secrets';\nexport * from './thresholds';\nexport * from './time';\nexport * from './time-series-data';\nexport * from './time-series-queries';\nexport * from './trace-data';\nexport * from './profile-data';\nexport * from './log-data';\nexport * from './transforms';\nexport * from './units';\nexport * from './user';\nexport * from './variables';\nexport * from './value-mapping';\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,cAAc,iBAAiB;AAC/B,cAAc,cAAc;AAC5B,cAAc,eAAe;AAC7B,cAAc,mBAAmB;AACjC,cAAc,gBAAgB;AAC9B,cAAc,YAAY;AAC1B,cAAc,uBAAuB;AACrC,cAAc,sBAAsB;AACpC,cAAc,SAAS;AACvB,cAAc,eAAe;AAC7B,cAAc,SAAS;AACvB,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,WAAW;AACzB,cAAc,SAAS;AACvB,cAAc,gBAAgB;AAC9B,cAAc,WAAW;AACzB,cAAc,YAAY;AAC1B,cAAc,UAAU;AACxB,cAAc,aAAa;AAC3B,cAAc,UAAU;AACxB,cAAc,iBAAiB;AAC/B,cAAc,YAAY;AAC1B,cAAc,eAAe;AAC7B,cAAc,SAAS;AACvB,cAAc,qBAAqB;AACnC,cAAc,wBAAwB;AACtC,cAAc,eAAe;AAC7B,cAAc,iBAAiB;AAC/B,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,cAAc,UAAU;AACxB,cAAc,SAAS;AACvB,cAAc,cAAc;AAC5B,cAAc,kBAAkB"}

package/dist/model/otlp/common/v1/common.d.ts

@@ -6,11 +6,13 @@ export type AnyValue = {
     stringValue: string;
 } | {
     intValue: string;
+} | {
+    doubleValue: number;
 } | {
     boolValue: boolean;
 } | {
     arrayValue: {
-        values: AnyValue[];
+        values?: AnyValue[];
     };
 };
 export interface InstrumentationScope {

package/dist/model/otlp/common/v1/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../../src/model/otlp/common/v1/common.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GACtB;IAAE,UAAU,EAAE;QAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../../src/model/otlp/common/v1/common.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GACtB;IAAE,UAAU,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/model/otlp/common/v1/common.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/model/otlp/common/v1/common.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\n// https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/opentelemetry/proto/common/v1/common.proto\n\nexport interface KeyValue {\n  key: string;\n  value: AnyValue;\n}\n\nexport type AnyValue =\n  | { stringValue: string }\n  | { intValue: string }\n  | { boolValue: boolean }\n  | { arrayValue: { values: AnyValue[] } };\n\nexport interface InstrumentationScope {\n  name?: string;\n}\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,+GAA+G;AAa/G,WAEC"}
+{"version":3,"sources":["../../../../../src/model/otlp/common/v1/common.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\n// https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/opentelemetry/proto/common/v1/common.proto\n\nexport interface KeyValue {\n  key: string;\n  value: AnyValue;\n}\n\nexport type AnyValue =\n  | { stringValue: string }\n  | { intValue: string }\n  | { doubleValue: number }\n  | { boolValue: boolean }\n  | { arrayValue: { values?: AnyValue[] } };\n\nexport interface InstrumentationScope {\n  name?: string;\n}\n"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,+GAA+G;AAc/G,WAEC"}

package/dist/model/panel-group.d.ts

@@ -0,0 +1,63 @@
+import { PanelGroupId } from './panels';
+/**
+ * Panel Group Item Layout ID type. String identifier for items within a panel group.
+ */
+export type PanelGroupItemLayoutId = string;
+/**
+ * Base layout properties for positioning and sizing items in a grid.
+ * This is a framework-agnostic representation that can be used with various grid systems.
+ */
+export interface BaseLayout {
+    /**
+     * Item identifier
+     */
+    i: string;
+    /**
+     * X position in grid units
+     */
+    x: number;
+    /**
+     * Y position in grid units
+     */
+    y: number;
+    /**
+     * Width in grid units
+     */
+    w: number;
+    /**
+     * Height in grid units
+     */
+    h: number;
+}
+/**
+ * Layout information for an item within a panel group.
+ * Extends BaseLayout with a typed identifier.
+ */
+export interface PanelGroupItemLayout extends BaseLayout {
+    i: PanelGroupItemLayoutId;
+}
+/**
+ * Uniquely identifies an item in a PanelGroup.
+ */
+export interface PanelGroupItemId {
+    panelGroupId: PanelGroupId;
+    panelGroupItemLayoutId: PanelGroupItemLayoutId;
+    repeatVariable?: [string, string];
+}
+/**
+ * Definition of a panel group, containing layout and panel information.
+ */
+export interface PanelGroupDefinition {
+    id: PanelGroupId;
+    isCollapsed: boolean;
+    title?: string;
+    repeatedOriginId?: PanelGroupId;
+    repeatVariable?: string;
+    itemLayouts: PanelGroupItemLayout[];
+    itemPanelKeys: Record<PanelGroupItemLayoutId, string>;
+}
+/**
+ * Check if two PanelGroupItemId are equal
+ */
+export declare function isPanelGroupItemIdEqual(a?: PanelGroupItemId, b?: PanelGroupItemId): boolean;
+//# sourceMappingURL=panel-group.d.ts.map

package/dist/model/panel-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-group.d.ts","sourceRoot":"","sources":["../../src/model/panel-group.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,CAAC,EAAE,sBAAsB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,YAAY,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAE3F"}

package/dist/model/panel-group.js

@@ -0,0 +1,19 @@
+// Copyright 2025 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/**
+ * Check if two PanelGroupItemId are equal
+ */ export function isPanelGroupItemIdEqual(a, b) {
+    return a?.panelGroupId === b?.panelGroupId && a?.panelGroupItemLayoutId === b?.panelGroupItemLayoutId;
+}
+
+//# sourceMappingURL=panel-group.js.map

package/dist/model/panel-group.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/model/panel-group.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { PanelGroupId } from './panels';\n\n/**\n * Panel Group Item Layout ID type. String identifier for items within a panel group.\n */\nexport type PanelGroupItemLayoutId = string;\n\n/**\n * Base layout properties for positioning and sizing items in a grid.\n * This is a framework-agnostic representation that can be used with various grid systems.\n */\nexport interface BaseLayout {\n  /**\n   * Item identifier\n   */\n  i: string;\n  /**\n   * X position in grid units\n   */\n  x: number;\n  /**\n   * Y position in grid units\n   */\n  y: number;\n  /**\n   * Width in grid units\n   */\n  w: number;\n  /**\n   * Height in grid units\n   */\n  h: number;\n}\n\n/**\n * Layout information for an item within a panel group.\n * Extends BaseLayout with a typed identifier.\n */\nexport interface PanelGroupItemLayout extends BaseLayout {\n  i: PanelGroupItemLayoutId;\n}\n\n/**\n * Uniquely identifies an item in a PanelGroup.\n */\nexport interface PanelGroupItemId {\n  panelGroupId: PanelGroupId;\n  panelGroupItemLayoutId: PanelGroupItemLayoutId;\n  repeatVariable?: [string, string]; // Optional, used for repeated panel groups. Variable name and value.\n}\n\n/**\n * Definition of a panel group, containing layout and panel information.\n */\nexport interface PanelGroupDefinition {\n  id: PanelGroupId;\n  isCollapsed: boolean;\n  title?: string;\n  repeatedOriginId?: PanelGroupId; // ID of the original panel group from which this repeated group is derived\n  repeatVariable?: string; // Optional, used for repeated panel groups\n  itemLayouts: PanelGroupItemLayout[];\n  itemPanelKeys: Record<PanelGroupItemLayoutId, string>;\n}\n\n/**\n * Check if two PanelGroupItemId are equal\n */\nexport function isPanelGroupItemIdEqual(a?: PanelGroupItemId, b?: PanelGroupItemId): boolean {\n  return a?.panelGroupId === b?.panelGroupId && a?.panelGroupItemLayoutId === b?.panelGroupItemLayoutId;\n}\n"],"names":["isPanelGroupItemIdEqual","a","b","panelGroupId","panelGroupItemLayoutId"],"mappings":"AAAA,oCAAoC;AACpC,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAkEjC;;CAEC,GACD,OAAO,SAASA,wBAAwBC,CAAoB,EAAEC,CAAoB;IAChF,OAAOD,GAAGE,iBAAiBD,GAAGC,gBAAgBF,GAAGG,2BAA2BF,GAAGE;AACjF"}

package/dist/model/units/date.d.ts

@@ -0,0 +1,28 @@
+import { UnitGroupConfig, UnitConfig } from './types';
+type DateUnits = 'datetime-iso' | 'datetime-us' | 'datetime-local' | 'date-iso' | 'date-us' | 'date-local' | 'time-local' | 'time-iso' | 'time-us' | 'relative-time' | 'unix-timestamp' | 'unix-timestamp-ms';
+export type DateFormatOptions = {
+    unit?: DateUnits;
+    /**
+     * The locale to use for formatting. Defaults to the system's locale.
+     */
+    locale?: string;
+    /**
+     * The timezone to use for formatting. Defaults to the user's local timezone.
+     */
+    timeZone?: string;
+    /**
+     * For relative time formatting, the reference time to compare against.
+     * Defaults to current time.
+     */
+    referenceTime?: number;
+    /**
+     * This property is not used for date formatting, but is included for
+     * compatibility with the FormatControls UI component.
+     */
+    decimalPlaces?: number;
+};
+export declare const DATE_GROUP_CONFIG: UnitGroupConfig;
+export declare const DATE_UNIT_CONFIG: Readonly<Record<DateUnits, UnitConfig>>;
+export declare function formatDate(value: number, options?: DateFormatOptions): string;
+export {};
+//# sourceMappingURL=date.d.ts.map

package/dist/model/units/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/model/units/date.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD,KAAK,SAAS,GACV,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,eAAe,GACf,gBAAgB,GAChB,mBAAmB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAIF,eAAO,MAAM,iBAAiB,EAAE,eAE/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAiDpE,CAAC;AAqGF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwHjF"}

package/dist/model/units/date.js

@@ -0,0 +1,278 @@
+// Copyright 2025 The Perses Authors
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+const DATE_GROUP = 'Date';
+export const DATE_GROUP_CONFIG = {
+    label: 'Date & Time'
+};
+export const DATE_UNIT_CONFIG = {
+    'datetime-iso': {
+        group: DATE_GROUP,
+        label: 'DateTime (GMT)'
+    },
+    'datetime-us': {
+        group: DATE_GROUP,
+        label: 'DateTime (US-East)'
+    },
+    'datetime-local': {
+        group: DATE_GROUP,
+        label: 'DateTime (Browser Local)'
+    },
+    'date-iso': {
+        group: DATE_GROUP,
+        label: 'Date (GMT)'
+    },
+    'date-us': {
+        group: DATE_GROUP,
+        label: 'Date (US-East)'
+    },
+    'date-local': {
+        group: DATE_GROUP,
+        label: 'Date (Browser Local)'
+    },
+    'time-local': {
+        group: DATE_GROUP,
+        label: 'Time (Browser Local)'
+    },
+    'time-iso': {
+        group: DATE_GROUP,
+        label: 'Time (GMT)'
+    },
+    'time-us': {
+        group: DATE_GROUP,
+        label: 'Time (US-East)'
+    },
+    'relative-time': {
+        group: DATE_GROUP,
+        label: 'Relative Time'
+    },
+    'unix-timestamp': {
+        group: DATE_GROUP,
+        label: 'Unix Timestamp (s)'
+    },
+    'unix-timestamp-ms': {
+        group: DATE_GROUP,
+        label: 'Unix Timestamp (ms)'
+    }
+};
+/**
+ * Converts a numeric value to a Date object.
+ * Handles both Unix timestamps (seconds) and millisecond timestamps.
+ */ function valueToDate(value) {
+    // Timestamp detection logic with special case handling
+    // Main threshold stays at 10 billion to maintain existing behavior
+    // Handle special edge cases explicitly
+    // Special case: negative timestamps
+    if (value < 0) {
+        // For negative values, check magnitude to distinguish seconds vs milliseconds
+        // Large negative values (> 1 billion in magnitude) are likely milliseconds
+        // Small negative values are likely seconds (rare edge case)
+        if (Math.abs(value) > 10000000000) {
+            return new Date(value); // milliseconds
+        } else {
+            return new Date(value * 1000); // seconds
+        }
+    }
+    // Special case: year 9999 in seconds (~253402300799)
+    // This is a very specific edge case for far-future timestamps
+    if (value >= 250000000000 && value <= 260000000000) {
+        // Check if this looks like year 9999 in seconds
+        const asSeconds = new Date(value * 1000);
+        const year = asSeconds.getUTCFullYear();
+        if (year >= 9999) {
+            return asSeconds; // seconds
+        }
+    }
+    const SECONDS_THRESHOLD = 10000000000; // ~year 2286 - original threshold
+    if (value < SECONDS_THRESHOLD) {
+        // Assume it's in seconds
+        return new Date(value * 1000);
+    } else {
+        // Assume it's in milliseconds
+        return new Date(value);
+    }
+}
+/**
+ * Formats a relative time string using the Intl.RelativeTimeFormat API.
+ */ function formatRelativeTime(date, referenceTime, locale) {
+    const referenceDate = new Date(referenceTime);
+    const diffMs = date.getTime() - referenceDate.getTime();
+    const units = [
+        {
+            unit: 'year',
+            ms: 1000 * 60 * 60 * 24 * 365
+        },
+        {
+            unit: 'month',
+            ms: 1000 * 60 * 60 * 24 * 30
+        },
+        {
+            unit: 'week',
+            ms: 1000 * 60 * 60 * 24 * 7
+        },
+        {
+            unit: 'day',
+            ms: 1000 * 60 * 60 * 24
+        },
+        {
+            unit: 'hour',
+            ms: 1000 * 60 * 60
+        },
+        {
+            unit: 'minute',
+            ms: 1000 * 60
+        },
+        {
+            unit: 'second',
+            ms: 1000
+        }
+    ];
+    for (const { unit, ms } of units){
+        // Determine the value for the current unit, ensuring it's an integer for Intl.RelativeTimeFormat
+        const value = Math.round(diffMs / ms);
+        // If the absolute value is 1 or more, use this unit
+        if (Math.abs(value) >= 1) {
+            const rtf = new Intl.RelativeTimeFormat(locale, {
+                numeric: 'auto'
+            });
+            return rtf.format(value, unit);
+        }
+    }
+    // If less than a second, show "now" or "0 seconds"
+    const rtf = new Intl.RelativeTimeFormat(locale, {
+        numeric: 'auto'
+    });
+    return rtf.format(0, 'second');
+}
+/**
+ * Gets the browser's preferred locale with comprehensive fallbacks.
+ */ const getBrowserLocale = ()=>{
+    if (typeof navigator !== 'undefined') {
+        if (navigator.language) return navigator.language;
+        if (navigator.languages && navigator.languages.length > 0) {
+            const firstLanguage = navigator.languages[0];
+            if (firstLanguage) return firstLanguage;
+        }
+        // Legacy fallbacks for older browsers
+        const nav = navigator;
+        if (nav.userLanguage) return nav.userLanguage;
+        if (nav.browserLanguage) return nav.browserLanguage;
+        if (nav.systemLanguage) return nav.systemLanguage;
+    }
+    // Node.js or server-side fallback, or if navigator is not available/empty
+    return Intl.DateTimeFormat().resolvedOptions().locale || 'en-US';
+};
+export function formatDate(value, options = {}) {
+    const systemTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const { unit = 'datetime-local', locale = getBrowserLocale(), timeZone = systemTimeZone, referenceTime = Date.now() } = options;
+    // Handle raw timestamp display
+    if (unit === 'unix-timestamp') {
+        // Ensure it's in seconds. If it looks like milliseconds, convert.
+        const timestamp = value > 1000000000000 ? Math.floor(value / 1000) : value;
+        return timestamp.toString();
+    }
+    if (unit === 'unix-timestamp-ms') {
+        // Ensure it's in milliseconds. If it looks like seconds, convert.
+        // Use 100 billion as threshold - values < 100B are likely seconds, >= 100B are likely milliseconds
+        // This distinguishes between 999999999 (seconds) and 999999999000 (milliseconds)
+        const MILLISECONDS_THRESHOLD = 100000000000; // 100 billion
+        const timestamp = value < MILLISECONDS_THRESHOLD ? value * 1000 : value;
+        return Math.floor(timestamp).toString();
+    }
+    const date = valueToDate(value);
+    // Handle relative time
+    if (unit === 'relative-time') {
+        return formatRelativeTime(date, referenceTime, locale);
+    }
+    // Configure Intl.DateTimeFormat options based on unit
+    const formatOptions = {
+        timeZone
+    };
+    switch(unit){
+        case 'datetime-iso':
+            // datetime-iso should ALWAYS show GMT/UTC time
+            return date.toISOString();
+        case 'datetime-us':
+            {
+                // datetime-us should ALWAYS show date in US Eastern timezone
+                formatOptions.timeZone = 'America/New_York';
+                formatOptions.year = 'numeric';
+                formatOptions.month = '2-digit';
+                formatOptions.day = '2-digit';
+                formatOptions.hour = '2-digit';
+                formatOptions.minute = '2-digit';
+                formatOptions.second = '2-digit';
+                formatOptions.hour12 = true; // 12-hour format with AM/PM
+                const formatter = new Intl.DateTimeFormat('en-US', formatOptions);
+                return formatter.format(date);
+            }
+        case 'datetime-local':
+            // datetime-local should use the browser's local timezone (detected automatically)
+            // Don't override timeZone - let it use the detected system timezone
+            formatOptions.year = 'numeric';
+            formatOptions.month = '2-digit';
+            formatOptions.day = '2-digit';
+            formatOptions.hour = '2-digit';
+            formatOptions.minute = '2-digit';
+            formatOptions.second = '2-digit';
+            formatOptions.hour12 = false; // 24-hour format
+            break;
+        case 'date-iso':
+            // date-iso should ALWAYS show GMT/UTC date
+            return date.toISOString().split('T')[0];
+        case 'date-us':
+            {
+                // date-us should ALWAYS show date in US Eastern timezone
+                formatOptions.timeZone = 'America/New_York';
+                formatOptions.year = 'numeric';
+                formatOptions.month = '2-digit';
+                formatOptions.day = '2-digit';
+                const formatter = new Intl.DateTimeFormat('en-US', formatOptions);
+                return formatter.format(date);
+            }
+        case 'date-local':
+            formatOptions.year = 'numeric';
+            formatOptions.month = '2-digit';
+            formatOptions.day = '2-digit';
+            break;
+        case 'time-local':
+            formatOptions.hour = '2-digit';
+            formatOptions.minute = '2-digit';
+            formatOptions.second = '2-digit';
+            formatOptions.hour12 = false; // 24-hour format
+            break;
+        case 'time-iso':
+            // time-iso should ALWAYS show GMT/UTC time
+            return date.toISOString().split('T')[1].replace('Z', '');
+        case 'time-us':
+            {
+                // time-us should show time in US-East timezone (Eastern Time)
+                formatOptions.timeZone = 'America/New_York';
+                formatOptions.hour = '2-digit';
+                formatOptions.minute = '2-digit';
+                formatOptions.second = '2-digit';
+                formatOptions.hour12 = true;
+                return new Intl.DateTimeFormat('en-US', formatOptions).format(date);
+            }
+        default:
+            {
+                // This ensures that all DateUnits are handled at compile time.
+                const exhaustive = unit;
+                throw new Error(`Unknown date unit: ${exhaustive}`);
+            }
+    }
+    // For all other units, use Intl.DateTimeFormat with the specified locale and options
+    const formatter = new Intl.DateTimeFormat(locale, formatOptions);
+    return formatter.format(date);
+}
+
+//# sourceMappingURL=date.js.map

package/dist/model/units/date.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/model/units/date.ts"],"sourcesContent":["// Copyright 2025 The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { UnitGroupConfig, UnitConfig } from './types';\n\ntype DateUnits =\n  | 'datetime-iso'\n  | 'datetime-us'\n  | 'datetime-local'\n  | 'date-iso'\n  | 'date-us'\n  | 'date-local'\n  | 'time-local'\n  | 'time-iso'\n  | 'time-us'\n  | 'relative-time'\n  | 'unix-timestamp'\n  | 'unix-timestamp-ms';\n\nexport type DateFormatOptions = {\n  unit?: DateUnits;\n  /**\n   * The locale to use for formatting. Defaults to the system's locale.\n   */\n  locale?: string;\n  /**\n   * The timezone to use for formatting. Defaults to the user's local timezone.\n   */\n  timeZone?: string;\n  /**\n   * For relative time formatting, the reference time to compare against.\n   * Defaults to current time.\n   */\n  referenceTime?: number;\n  /**\n   * This property is not used for date formatting, but is included for\n   * compatibility with the FormatControls UI component.\n   */\n  decimalPlaces?: number;\n};\n\nconst DATE_GROUP = 'Date';\n\nexport const DATE_GROUP_CONFIG: UnitGroupConfig = {\n  label: 'Date & Time',\n};\n\nexport const DATE_UNIT_CONFIG: Readonly<Record<DateUnits, UnitConfig>> = {\n  'datetime-iso': {\n    group: DATE_GROUP,\n    label: 'DateTime (GMT)',\n  },\n  'datetime-us': {\n    group: DATE_GROUP,\n    label: 'DateTime (US-East)',\n  },\n  'datetime-local': {\n    group: DATE_GROUP,\n    label: 'DateTime (Browser Local)',\n  },\n  'date-iso': {\n    group: DATE_GROUP,\n    label: 'Date (GMT)',\n  },\n  'date-us': {\n    group: DATE_GROUP,\n    label: 'Date (US-East)',\n  },\n  'date-local': {\n    group: DATE_GROUP,\n    label: 'Date (Browser Local)',\n  },\n  'time-local': {\n    group: DATE_GROUP,\n    label: 'Time (Browser Local)',\n  },\n  'time-iso': {\n    group: DATE_GROUP,\n    label: 'Time (GMT)',\n  },\n  'time-us': {\n    group: DATE_GROUP,\n    label: 'Time (US-East)',\n  },\n  'relative-time': {\n    group: DATE_GROUP,\n    label: 'Relative Time',\n  },\n  'unix-timestamp': {\n    group: DATE_GROUP,\n    label: 'Unix Timestamp (s)',\n  },\n  'unix-timestamp-ms': {\n    group: DATE_GROUP,\n    label: 'Unix Timestamp (ms)',\n  },\n};\n\n/**\n * Converts a numeric value to a Date object.\n * Handles both Unix timestamps (seconds) and millisecond timestamps.\n */\nfunction valueToDate(value: number): Date {\n  // Timestamp detection logic with special case handling\n  // Main threshold stays at 10 billion to maintain existing behavior\n  // Handle special edge cases explicitly\n\n  // Special case: negative timestamps\n  if (value < 0) {\n    // For negative values, check magnitude to distinguish seconds vs milliseconds\n    // Large negative values (> 1 billion in magnitude) are likely milliseconds\n    // Small negative values are likely seconds (rare edge case)\n    if (Math.abs(value) > 10000000000) {\n      return new Date(value); // milliseconds\n    } else {\n      return new Date(value * 1000); // seconds\n    }\n  }\n\n  // Special case: year 9999 in seconds (~253402300799)\n  // This is a very specific edge case for far-future timestamps\n  if (value >= 250000000000 && value <= 260000000000) {\n    // Check if this looks like year 9999 in seconds\n    const asSeconds = new Date(value * 1000);\n    const year = asSeconds.getUTCFullYear();\n    if (year >= 9999) {\n      return asSeconds; // seconds\n    }\n  }\n\n  const SECONDS_THRESHOLD = 10000000000; // ~year 2286 - original threshold\n\n  if (value < SECONDS_THRESHOLD) {\n    // Assume it's in seconds\n    return new Date(value * 1000);\n  } else {\n    // Assume it's in milliseconds\n    return new Date(value);\n  }\n}\n\n/**\n * Formats a relative time string using the Intl.RelativeTimeFormat API.\n */\nfunction formatRelativeTime(date: Date, referenceTime: number, locale: string): string {\n  const referenceDate = new Date(referenceTime);\n  const diffMs = date.getTime() - referenceDate.getTime();\n\n  const units = [\n    { unit: 'year', ms: 1000 * 60 * 60 * 24 * 365 },\n    { unit: 'month', ms: 1000 * 60 * 60 * 24 * 30 },\n    { unit: 'week', ms: 1000 * 60 * 60 * 24 * 7 },\n    { unit: 'day', ms: 1000 * 60 * 60 * 24 },\n    { unit: 'hour', ms: 1000 * 60 * 60 },\n    { unit: 'minute', ms: 1000 * 60 },\n    { unit: 'second', ms: 1000 },\n  ] as const;\n\n  for (const { unit, ms } of units) {\n    // Determine the value for the current unit, ensuring it's an integer for Intl.RelativeTimeFormat\n    const value = Math.round(diffMs / ms);\n    // If the absolute value is 1 or more, use this unit\n    if (Math.abs(value) >= 1) {\n      const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n      return rtf.format(value, unit);\n    }\n  }\n\n  // If less than a second, show \"now\" or \"0 seconds\"\n  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });\n  return rtf.format(0, 'second');\n}\n\n/**\n * Gets the browser's preferred locale with comprehensive fallbacks.\n */\nconst getBrowserLocale = (): string => {\n  if (typeof navigator !== 'undefined') {\n    if (navigator.language) return navigator.language;\n    if (navigator.languages && navigator.languages.length > 0) {\n      const firstLanguage = navigator.languages[0];\n      if (firstLanguage) return firstLanguage;\n    }\n    // Legacy fallbacks for older browsers\n    const nav = navigator as Navigator & {\n      userLanguage?: string;\n      browserLanguage?: string;\n      systemLanguage?: string;\n    };\n    if (nav.userLanguage) return nav.userLanguage;\n    if (nav.browserLanguage) return nav.browserLanguage;\n    if (nav.systemLanguage) return nav.systemLanguage;\n  }\n  // Node.js or server-side fallback, or if navigator is not available/empty\n  return Intl.DateTimeFormat().resolvedOptions().locale || 'en-US';\n};\n\nexport function formatDate(value: number, options: DateFormatOptions = {}): string {\n  const systemTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;\n\n  const {\n    unit = 'datetime-local',\n    locale = getBrowserLocale(),\n    timeZone = systemTimeZone,\n    referenceTime = Date.now(),\n  } = options;\n\n  // Handle raw timestamp display\n  if (unit === 'unix-timestamp') {\n    // Ensure it's in seconds. If it looks like milliseconds, convert.\n    const timestamp = value > 1000000000000 ? Math.floor(value / 1000) : value;\n    return timestamp.toString();\n  }\n\n  if (unit === 'unix-timestamp-ms') {\n    // Ensure it's in milliseconds. If it looks like seconds, convert.\n    // Use 100 billion as threshold - values < 100B are likely seconds, >= 100B are likely milliseconds\n    // This distinguishes between 999999999 (seconds) and 999999999000 (milliseconds)\n    const MILLISECONDS_THRESHOLD = 100000000000; // 100 billion\n    const timestamp = value < MILLISECONDS_THRESHOLD ? value * 1000 : value;\n    return Math.floor(timestamp).toString();\n  }\n\n  const date = valueToDate(value);\n\n  // Handle relative time\n  if (unit === 'relative-time') {\n    return formatRelativeTime(date, referenceTime, locale);\n  }\n\n  // Configure Intl.DateTimeFormat options based on unit\n  const formatOptions: Intl.DateTimeFormatOptions = {\n    timeZone, // This will be overridden for specific units that need different timezones\n  };\n\n  switch (unit) {\n    case 'datetime-iso':\n      // datetime-iso should ALWAYS show GMT/UTC time\n      return date.toISOString();\n\n    case 'datetime-us': {\n      // datetime-us should ALWAYS show date in US Eastern timezone\n      formatOptions.timeZone = 'America/New_York';\n      formatOptions.year = 'numeric';\n      formatOptions.month = '2-digit';\n      formatOptions.day = '2-digit';\n      formatOptions.hour = '2-digit';\n      formatOptions.minute = '2-digit';\n      formatOptions.second = '2-digit';\n      formatOptions.hour12 = true; // 12-hour format with AM/PM\n      const formatter = new Intl.DateTimeFormat('en-US', formatOptions);\n      return formatter.format(date);\n    }\n\n    case 'datetime-local':\n      // datetime-local should use the browser's local timezone (detected automatically)\n      // Don't override timeZone - let it use the detected system timezone\n      formatOptions.year = 'numeric';\n      formatOptions.month = '2-digit';\n      formatOptions.day = '2-digit';\n      formatOptions.hour = '2-digit';\n      formatOptions.minute = '2-digit';\n      formatOptions.second = '2-digit';\n      formatOptions.hour12 = false; // 24-hour format\n      break;\n\n    case 'date-iso':\n      // date-iso should ALWAYS show GMT/UTC date\n      return date.toISOString().split('T')[0]!;\n\n    case 'date-us': {\n      // date-us should ALWAYS show date in US Eastern timezone\n      formatOptions.timeZone = 'America/New_York';\n      formatOptions.year = 'numeric';\n      formatOptions.month = '2-digit';\n      formatOptions.day = '2-digit';\n      const formatter = new Intl.DateTimeFormat('en-US', formatOptions);\n      return formatter.format(date);\n    }\n\n    case 'date-local':\n      formatOptions.year = 'numeric';\n      formatOptions.month = '2-digit';\n      formatOptions.day = '2-digit';\n      break;\n\n    case 'time-local':\n      formatOptions.hour = '2-digit';\n      formatOptions.minute = '2-digit';\n      formatOptions.second = '2-digit';\n      formatOptions.hour12 = false; // 24-hour format\n      break;\n\n    case 'time-iso':\n      // time-iso should ALWAYS show GMT/UTC time\n      return date.toISOString().split('T')[1]!.replace('Z', '');\n\n    case 'time-us': {\n      // time-us should show time in US-East timezone (Eastern Time)\n      formatOptions.timeZone = 'America/New_York';\n      formatOptions.hour = '2-digit';\n      formatOptions.minute = '2-digit';\n      formatOptions.second = '2-digit';\n      formatOptions.hour12 = true;\n      return new Intl.DateTimeFormat('en-US', formatOptions).format(date);\n    }\n\n    default: {\n      // This ensures that all DateUnits are handled at compile time.\n      const exhaustive: never = unit;\n      throw new Error(`Unknown date unit: ${exhaustive}`);\n    }\n  }\n\n  // For all other units, use Intl.DateTimeFormat with the specified locale and options\n  const formatter = new Intl.DateTimeFormat(locale, formatOptions);\n  return formatter.format(date);\n}\n"],"names":["DATE_GROUP","DATE_GROUP_CONFIG","label","DATE_UNIT_CONFIG","group","valueToDate","value","Math","abs","Date","asSeconds","year","getUTCFullYear","SECONDS_THRESHOLD","formatRelativeTime","date","referenceTime","locale","referenceDate","diffMs","getTime","units","unit","ms","round","rtf","Intl","RelativeTimeFormat","numeric","format","getBrowserLocale","navigator","language","languages","length","firstLanguage","nav","userLanguage","browserLanguage","systemLanguage","DateTimeFormat","resolvedOptions","formatDate","options","systemTimeZone","timeZone","now","timestamp","floor","toString","MILLISECONDS_THRESHOLD","formatOptions","toISOString","month","day","hour","minute","second","hour12","formatter","split","replace","exhaustive","Error"],"mappings":"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"}

package/dist/model/units/temperature.d.ts

@@ -0,0 +1,11 @@
+import { UnitConfig, UnitGroupConfig } from './types';
+type TemperatureUnits = 'celsius' | 'fahrenheit';
+export type TemperatureFormatOptions = {
+    unit: TemperatureUnits;
+    decimalPlaces?: number;
+};
+export declare const TEMPERATURE_GROUP_CONFIG: UnitGroupConfig;
+export declare const TEMPERATURE_UNIT_CONFIG: Readonly<Record<TemperatureUnits, UnitConfig>>;
+export declare const formatTemperature: (value: number, { unit, decimalPlaces }: TemperatureFormatOptions) => string;
+export {};
+//# sourceMappingURL=temperature.d.ts.map

package/dist/model/units/temperature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temperature.d.ts","sourceRoot":"","sources":["../../../src/model/units/temperature.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKtD,KAAK,gBAAgB,GAAG,SAAS,GAAG,YAAY,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,eAGtC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC,CASlF,CAAC;AAEF,eAAO,MAAM,iBAAiB,UAAW,MAAM,2BAA2B,wBAAwB,KAAG,MAepG,CAAC"}