semanticdb-v2 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/semantic-types/resolve-schema.d.ts

@@ -1,4 +1,4 @@
 import type { SemanticDBPlugin } from '../plugins/index';
 import type { SemanticTypeRegistry } from './registry';
 import type { ResolvedSemanticSchema, SemanticSchemaDraft } from './types';
-export declare const resolveSchema: (schema: SemanticSchemaDraft, registry: SemanticTypeRegistry, externalPlugins?: readonly SemanticDBPlugin[]) => ResolvedSemanticSchema;
+export declare const resolveSchema: (inputSchema: SemanticSchemaDraft, registry: SemanticTypeRegistry, externalPlugins?: readonly SemanticDBPlugin[]) => ResolvedSemanticSchema;

package/dist/semantic-types/types.d.ts

@@ -1,8 +1,14 @@
 import type { PropertyTypeDraft, SchemaTypeDraft } from 'semanticdb-core';
 import type { LogicformType, PredItemType } from '../logicform-types';
-export type PrimalType = 'string' | 'number' | 'boolean' | 'date' | 'object';
+/** Canonical primitive types use `entity`; `object` remains a legacy input alias. */
+export type PrimalType = 'string' | 'number' | 'boolean' | 'date' | 'entity' | 'object';
 export type TimeGranularity = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
-export type TemporalSemantics = 'normal' | 'snapshot';
+export type TimeWatermarkPolicy = {
+    readonly type: 'database_latest';
+} | {
+    readonly type: 'now_offset';
+    readonly offset: number;
+};
 export interface PropertySqlDefinition {
     readonly sql: string;
 }
@@ -10,6 +16,11 @@ export interface ComparableCategoryDefinition {
     readonly values: readonly string[];
     readonly direction: 1 | -1;
 }
+/** Same-Schema Property drill metadata. `up` is the single-valued side. */
+export interface PropertyHierarchyDefinition {
+    readonly up?: string;
+    readonly down?: string;
+}
 /** Extension point for plugin-owned Schema draft metadata. */
 export interface SemanticSchemaMetadata {
 }
@@ -19,7 +30,7 @@ export interface ResolvedSemanticSchemaMetadata {
 /** Extension point for legacy plugin metadata removed from the canonical Schema shape. */
 export interface LegacySemanticSchemaMetadata {
 }
-export interface SemanticPropertyDraft extends Omit<PropertyTypeDraft, '_id' | '_sid' | 'id' | 'sid' | 'type' | 'primal_type' | 'isArray' | 'granularity' | 'is_observation' | 'is_snapshot' | 'temporalSemantics' | 'is_dynamic' | 'udf' | 'is_comparable' | 'comparable_order'> {
+export interface SemanticPropertyDraft extends Omit<PropertyTypeDraft, '_id' | '_sid' | 'id' | 'sid' | 'type' | 'primal_type' | 'isArray' | 'granularity' | 'is_observation' | 'is_snapshot' | 'temporalSemantics' | 'is_dynamic' | 'udf' | 'is_comparable' | 'comparable_order' | 'hierarchy'> {
     readonly id?: string;
     readonly type: string;
     readonly primal_type?: PrimalType;
@@ -39,24 +50,21 @@ export interface ResolvedSemanticProperty extends Omit<SemanticPropertyDraft, 'i
 export interface SemanticSchemaDraft extends Omit<SchemaTypeDraft, '_id' | 'id' | 'sid' | 'properties' | 'db' | 'from' | 'fromSQL' | 'projections' | keyof SemanticSchemaMetadata | keyof LegacySemanticSchemaMetadata>, SemanticSchemaMetadata {
     readonly [key: string]: unknown;
     readonly id: string;
+    /** Marks the single Schema whose complete rows are loaded as calendar execution context. */
+    readonly is_calendar?: boolean;
     readonly properties: readonly SemanticPropertyDraft[];
-    readonly temporalSemantics?: TemporalSemantics;
-    /** Property that stores the parent node id for recursive tree queries. */
-    readonly parentProperty?: string;
 }
 export interface ResolvedSemanticSchema extends Omit<SchemaTypeDraft, '_id' | 'id' | 'sid' | 'properties' | 'db' | 'from' | 'fromSQL' | 'projections' | keyof SemanticSchemaMetadata | keyof LegacySemanticSchemaMetadata>, ResolvedSemanticSchemaMetadata {
     readonly [key: string]: unknown;
     readonly id: string;
+    readonly is_calendar?: boolean;
     readonly properties: readonly ResolvedSemanticProperty[];
-    readonly temporalSemantics?: TemporalSemantics;
-    /** Canonical logical name of the parent Property used by recursive tree queries. */
-    readonly parentProperty?: string;
 }
 export interface SemanticTypeNormalizeContext {
     readonly schema: ResolvedSemanticSchema;
     readonly property: ResolvedSemanticProperty;
     readonly now: Date;
-    readonly requestLatestDataDate: () => Promise<Date | undefined>;
+    readonly requestTimeWatermark: (requestedUpperBound: Date) => Promise<Date | undefined>;
 }
 /** Context used when deciding whether a value must be evaluated per time period. */
 export interface SemanticPeriodEvaluationContext {
@@ -81,6 +89,10 @@ export interface SemanticTypeResultContext {
 export interface SemanticTypeDefinition {
     readonly name: string;
     readonly primalType: PrimalType;
+    /** Semantic types with an intrinsic array container, such as tag. */
+    readonly isArray?: true;
+    /** Normalize a complete physical value before per-element result hydration. */
+    readonly normalizeResult?: (value: unknown, context: SemanticTypeResultContext) => unknown;
     readonly validateProperty?: (property: ResolvedSemanticProperty) => void;
     /** Whether this semantic property requires one evaluation per time bucket. */
     readonly requiresPerPeriodEvaluation?: (context: SemanticPeriodEvaluationContext) => boolean;

package/dist/semantic-types/validate-resolved-schema.d.ts

@@ -1,6 +1,3 @@
-import type { ResolvedSemanticProperty, TemporalSemantics } from './types';
+import type { ResolvedSemanticProperty } from './types';
 /** Validates invariants that require the complete set of resolved Properties. */
-export declare const validateResolvedSchema: (properties: readonly ResolvedSemanticProperty[], options?: {
-    readonly temporalSemantics?: TemporalSemantics;
-    readonly schemaId?: string;
-}) => void;
+export declare const validateResolvedSchema: (properties: readonly ResolvedSemanticProperty[]) => void;