@snaptrude/plugin-core 0.8.0 → 0.9.0

package/dist/api/analysis/solar.d.ts

@@ -0,0 +1,249 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+/**
+ * Analysis solar — sample solar exposure at caller-chosen points.
+ *
+ * Unlike the heatmap studies (which raster the model's own surfaces), this
+ * samples solar exposure at **points you supply** — an instant (sun visible? /
+ * irradiance now) or aggregated over a date range (shaded fraction / cumulative
+ * irradiance). Positions are **world plan-space** coordinates, the same units
+ * and frame as plugin geometry reads; the backend echoes them verbatim and
+ * never re-projects.
+ *
+ * Raw numbers only: this renders no heatmap, mutates no geometry, and writes no
+ * save commands — visualization is the plugin's job. Large grids run as a job
+ * (`status: "running"` until complete); every result carries `modelRevision` +
+ * `inputHash` so the caller can mark it stale after a geometry change.
+ *
+ * Accessed via `snaptrude.analysis.solar`.
+ */
+export declare abstract class PluginAnalysisSolarApi {
+    constructor();
+    /**
+     * Sample solar exposure at a set of points.
+     *
+     * Provide **exactly one** timing mode: `dateTime` (a single instant →
+     * `mode: "instant"`, results in `W/m²`), or `startDate` + `endDate` (a range
+     * → `mode: "range"`, results aggregated in `kWh/m²`). `results` is paged —
+     * follow `nextCursor` until it is `null`. Each point's optional `normal`
+     * gives plane-of-array irradiance; omit it for a horizontal sample.
+     *
+     * @param args - {@linkcode PluginSolarSampleGridArgs}: the `points`, exactly
+     *   one timing mode (`dateTime` XOR `startDate`+`endDate`), and an optional
+     *   `includeHourlyArtifact` to attach a downloadable per-hour series.
+     * @returns A {@linkcode PluginSolarSampleGridResult} — the run `status`,
+     *   `mode`/`units`, provenance (`weather`, `modelRevision`, `inputHash`),
+     *   this page of `results`, an optional `hourlyArtifact`, and `nextCursor`.
+     * @throws When the project has no geo-located site (no location to sample
+     *   solar exposure for).
+     *
+     * @examplePrompt What's the irradiance at these facade points at noon on June 21?
+     * @examplePrompt How shaded are these balcony points across the summer?
+     * @examplePrompt Sample direct sun visibility at these roof points right now
+     *
+     * # Example
+     * ```ts
+     * const grid = await snaptrude.analysis.solar.sampleGrid({
+     *   points: [
+     *     { id: "a", position: [0, 3, 0] },
+     *     { id: "b", position: [5, 3, 0], normal: [0, 0, 1] },
+     *   ],
+     *   dateTime: "2026-06-21T12:00:00+05:30",
+     * })
+     * for (const r of grid.results) {
+     *   console.log(r.id, r.directSunVisible, r.totalIrradiance, grid.units)
+     * }
+     * ```
+     */
+    abstract sampleGrid(args: PluginSolarSampleGridArgs): PluginApiReturn<PluginSolarSampleGridResult>;
+}
+/**
+ * Status of a {@linkcode PluginAnalysisSolarApi.sampleGrid} run.
+ *
+ * | Value | Meaning |
+ * |---|---|
+ * | `"running"` | The job is in flight — poll again |
+ * | `"complete"` | Results are final |
+ * | `"cancelled"` | The run was cancelled |
+ * | `"failed"` | The run failed |
+ */
+export declare const PluginSolarRunStatus: z.ZodEnum<{
+    complete: "complete";
+    failed: "failed";
+    running: "running";
+    cancelled: "cancelled";
+}>;
+export type PluginSolarRunStatus = z.infer<typeof PluginSolarRunStatus>;
+/**
+ * Timing mode of the run — chosen by which timing args were supplied.
+ *
+ * | Value | Meaning |
+ * |---|---|
+ * | `"instant"` | Single `dateTime` — irradiance in `W/m²` |
+ * | `"range"` | `startDate`+`endDate` — irradiance aggregated in `kWh/m²` |
+ */
+export declare const PluginSolarSampleMode: z.ZodEnum<{
+    range: "range";
+    instant: "instant";
+}>;
+export type PluginSolarSampleMode = z.infer<typeof PluginSolarSampleMode>;
+/**
+ * Irradiance units of the results — `W/m²` (instant) or `kWh/m²` (range).
+ */
+export declare const PluginSolarUnits: z.ZodEnum<{
+    "W/m2": "W/m2";
+    "kWh/m2": "kWh/m2";
+}>;
+export type PluginSolarUnits = z.infer<typeof PluginSolarUnits>;
+/**
+ * Downloadable per-hour artifact (present only when `includeHourlyArtifact`).
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `url` | `string` | Signed download URL |
+ * | `format` | `"parquet" \| "csv-gz"` | File format |
+ * | `expiresAt` | `string` | ISO 8601 expiry of the signed URL |
+ */
+export declare const PluginSolarHourlyArtifact: z.ZodObject<{
+    url: z.ZodString;
+    format: z.ZodEnum<{
+        parquet: "parquet";
+        "csv-gz": "csv-gz";
+    }>;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type PluginSolarHourlyArtifact = z.infer<typeof PluginSolarHourlyArtifact>;
+/**
+ * A caller-supplied point to sample.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `id` | `string` | Caller-chosen id, echoed back verbatim on the result |
+ * | `position` | `[number, number, number]` | World plan-space `[x, y, z]` |
+ * | `normal` | `[number, number, number]`? | Surface normal for plane-of-array; omit = horizontal |
+ */
+export declare const PluginSolarSamplePoint: z.ZodObject<{
+    id: z.ZodString;
+    position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    normal: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strip>;
+export type PluginSolarSamplePoint = z.infer<typeof PluginSolarSamplePoint>;
+/**
+ * Arguments for {@linkcode PluginAnalysisSolarApi.sampleGrid}.
+ *
+ * Provide **exactly one** timing mode: `dateTime` (instant) XOR
+ * `startDate`+`endDate` (range).
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `points` | {@linkcode PluginSolarSamplePoint}`[]` | Points to sample |
+ * | `dateTime` | `string`? | Instant mode: local ISO 8601 with offset |
+ * | `startDate` | `string`? | Range mode: inclusive start `"YYYY-MM-DD"` |
+ * | `endDate` | `string`? | Range mode: inclusive end `"YYYY-MM-DD"` |
+ * | `includeHourlyArtifact` | `boolean`? | Attach a downloadable per-hour series |
+ */
+export declare const PluginSolarSampleGridArgs: z.ZodObject<{
+    points: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        normal: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strip>>;
+    dateTime: z.ZodOptional<z.ZodString>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    includeHourlyArtifact: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginSolarSampleGridArgs = z.infer<typeof PluginSolarSampleGridArgs>;
+/**
+ * One sampled point's result. Irradiance fields are in the enclosing result's
+ * `units` and are omitted when the backend did not compute them.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `id` | `string` | The point's caller-chosen id |
+ * | `directSunVisible` | `boolean` | Instant mode: sun disc visible from the point |
+ * | `shadeFraction` | `number` | `0`..`1`; range mode: fraction of sun-up hours shaded |
+ * | `directIrradiance` | `number`? | Direct component, in the result's `units` |
+ * | `diffuseIrradiance` | `number`? | Diffuse component, in the result's `units` |
+ * | `totalIrradiance` | `number`? | Total (direct + diffuse), in the result's `units` |
+ */
+export declare const PluginSolarSampleResult: z.ZodObject<{
+    id: z.ZodString;
+    directSunVisible: z.ZodBoolean;
+    shadeFraction: z.ZodNumber;
+    directIrradiance: z.ZodOptional<z.ZodNumber>;
+    diffuseIrradiance: z.ZodOptional<z.ZodNumber>;
+    totalIrradiance: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginSolarSampleResult = z.infer<typeof PluginSolarSampleResult>;
+/**
+ * Result of {@linkcode PluginAnalysisSolarApi.sampleGrid} — one page.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `status` | {@linkcode PluginSolarRunStatus} | Run status |
+ * | `mode` | {@linkcode PluginSolarSampleMode} | `"instant"` or `"range"` |
+ * | `coordinateSystem` | `"world-plan-space"` | Echo of the input frame |
+ * | `modelRevision` | `string` | Geometry revision sampled against (staleness key) |
+ * | `inputHash` | `string` | Hash of points+dates+geometry (staleness key) |
+ * | `units` | {@linkcode PluginSolarUnits} | `"W/m2"` (instant) or `"kWh/m2"` (range) |
+ * | `sunUpHours` | `number` | Sun-up hours over the sampled window |
+ * | `weather` | {@linkcode PluginWeatherSourceMeta} \| `null` | Resolved weather file, or `null` |
+ * | `weatherQuality` | `string[]` | Deduped quality flags present in the consumed rows |
+ * | `results` | {@linkcode PluginSolarSampleResult}`[]` | This page of per-point results |
+ * | `hourlyArtifact` | {@linkcode PluginSolarHourlyArtifact} \| `null` | Per-hour download, or `null` |
+ * | `nextCursor` | `string \| null` | Next page cursor; `null` = last page |
+ */
+export declare const PluginSolarSampleGridResult: z.ZodObject<{
+    status: z.ZodEnum<{
+        complete: "complete";
+        failed: "failed";
+        running: "running";
+        cancelled: "cancelled";
+    }>;
+    mode: z.ZodEnum<{
+        range: "range";
+        instant: "instant";
+    }>;
+    coordinateSystem: z.ZodLiteral<"world-plan-space">;
+    modelRevision: z.ZodString;
+    inputHash: z.ZodString;
+    units: z.ZodEnum<{
+        "W/m2": "W/m2";
+        "kWh/m2": "kWh/m2";
+    }>;
+    sunUpHours: z.ZodNumber;
+    weather: z.ZodNullable<z.ZodObject<{
+        weatherFileId: z.ZodString;
+        station: z.ZodString;
+        sourceId: z.ZodString;
+        distanceKm: z.ZodNullable<z.ZodNumber>;
+        selectionMethod: z.ZodEnum<{
+            "nearest-station": "nearest-station";
+            "user-upload": "user-upload";
+            "project-override": "project-override";
+        }>;
+        checksum: z.ZodString;
+        windReferenceHeightM: z.ZodNumber;
+    }, z.core.$strip>>;
+    weatherQuality: z.ZodArray<z.ZodString>;
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        directSunVisible: z.ZodBoolean;
+        shadeFraction: z.ZodNumber;
+        directIrradiance: z.ZodOptional<z.ZodNumber>;
+        diffuseIrradiance: z.ZodOptional<z.ZodNumber>;
+        totalIrradiance: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    hourlyArtifact: z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        format: z.ZodEnum<{
+            parquet: "parquet";
+            "csv-gz": "csv-gz";
+        }>;
+        expiresAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PluginSolarSampleGridResult = z.infer<typeof PluginSolarSampleGridResult>;
+//# sourceMappingURL=solar.d.ts.map

package/dist/api/analysis/solar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solar.d.ts","sourceRoot":"","sources":["../../../src/api/analysis/solar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAG7C;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,sBAAsB;;IAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;aACa,UAAU,CACxB,IAAI,EAAE,yBAAyB,GAC9B,eAAe,CAAC,2BAA2B,CAAC;CAChD;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;EAA+B,CAAA;AACjE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAA6B,CAAA;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;;;;;;;iBAIpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;iBAIjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;iBA0BlC,CAAA;AACJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB;;;;;;;iBAOlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAatC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAA"}

package/dist/api/analysis/weather.d.ts

@@ -0,0 +1,193 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../types";
+/**
+ * Analysis weather — read the project site's typical-year weather series.
+ *
+ * Returns the hourly weather rows (temperature, humidity, wind, solar
+ * irradiance) of the EPW file the sustainability analyses compute against,
+ * resolved from the project's geo-located site. This is a **synchronous,
+ * paged read** of an already-resolved weather file — not a job: call
+ * {@linkcode PluginAnalysisWeatherApi.getSeries} for a date range, then follow
+ * `nextCursor` until it is `null`.
+ *
+ * The weather file is resolved by the **same** code path the daylight /
+ * sunlight-hours analyses use, so the `source.weatherFileId` here matches the
+ * provenance a {@linkcode PluginAnalysisDaylightApi} run echoes. Dates cross as
+ * ISO 8601 date strings (`"YYYY-MM-DD"`); each row's `timestamp` is a local
+ * ISO 8601 string **with** its UTC offset, and `utcOffsetMinutes` restates the
+ * offset so consumers never re-derive it.
+ *
+ * Reads never throw for "no data": when the project has no geo-located site
+ * (no weather file to resolve) the host surfaces that per its read contract.
+ *
+ * Accessed via `snaptrude.analysis.weather`.
+ */
+export declare abstract class PluginAnalysisWeatherApi {
+    constructor();
+    /**
+     * Get the hourly weather series for a date range, paged.
+     *
+     * Returns the resolved weather file's provenance (`source`) plus the weather
+     * `rows` for the requested range. The page size is backend-chosen; when
+     * `nextCursor` is a string, pass it back as `args.cursor` to fetch the next
+     * page, and stop when it is `null`.
+     *
+     * @param args - {@linkcode PluginWeatherGetSeriesArgs}: the inclusive
+     *   `startDate`/`endDate` ISO dates, an optional `interval` (`"hourly"` is
+     *   the only v1 value), and an optional `cursor` for paging.
+     * @returns A {@linkcode PluginWeatherSeriesResult} — the resolved weather
+     *   `source`, the `rows` for this page, and `nextCursor` (`null` at the end).
+     *
+     * @examplePrompt Get the weather series for June at my site
+     * @examplePrompt Pull the hourly temperature and irradiance for this location
+     * @examplePrompt What EPW weather file is my project using?
+     *
+     * # Example
+     * ```ts
+     * let cursor: string | undefined = undefined
+     * const rows = []
+     * do {
+     *   const page = await snaptrude.analysis.weather.getSeries({
+     *     startDate: "2026-06-01",
+     *     endDate: "2026-06-30",
+     *     cursor,
+     *   })
+     *   rows.push(...page.rows)
+     *   cursor = page.nextCursor ?? undefined
+     * } while (cursor)
+     * ```
+     */
+    abstract getSeries(args: PluginWeatherGetSeriesArgs): PluginApiReturn<PluginWeatherSeriesResult>;
+}
+/**
+ * How the weather file was matched to the project site.
+ *
+ * | Value | Meaning |
+ * |---|---|
+ * | `"nearest-station"` | Auto-resolved to the closest weather station |
+ * | `"user-upload"` | A weather file the user uploaded (`core.io.import.epw`) |
+ * | `"project-override"` | A station pinned for the project regardless of distance |
+ */
+export declare const PluginWeatherSelectionMethod: z.ZodEnum<{
+    "nearest-station": "nearest-station";
+    "user-upload": "user-upload";
+    "project-override": "project-override";
+}>;
+export type PluginWeatherSelectionMethod = z.infer<typeof PluginWeatherSelectionMethod>;
+/**
+ * Provenance of the resolved weather file — where the numbers came from.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `weatherFileId` | `string` | Catalog id (same key as `core.io.import.epw`'s `weatherFileId`) |
+ * | `station` | `string` | Station/file name, e.g. `"USA_IL_Chicago-OHare.Intl.AP.725300_TMY3"` |
+ * | `sourceId` | `string` | WMO/station identifier from the EPW header |
+ * | `distanceKm` | `number \| null` | Station → project site distance, km; `null` for pinned project-override files |
+ * | `selectionMethod` | {@linkcode PluginWeatherSelectionMethod} | How the file was matched |
+ * | `checksum` | `string` | sha256 of the EPW file — the provenance key |
+ * | `windReferenceHeightM` | `number` | Anemometer height the wind rows are valid at |
+ */
+export declare const PluginWeatherSourceMeta: z.ZodObject<{
+    weatherFileId: z.ZodString;
+    station: z.ZodString;
+    sourceId: z.ZodString;
+    distanceKm: z.ZodNullable<z.ZodNumber>;
+    selectionMethod: z.ZodEnum<{
+        "nearest-station": "nearest-station";
+        "user-upload": "user-upload";
+        "project-override": "project-override";
+    }>;
+    checksum: z.ZodString;
+    windReferenceHeightM: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginWeatherSourceMeta = z.infer<typeof PluginWeatherSourceMeta>;
+/**
+ * One hourly weather reading.
+ *
+ * `flags` is empty for a clean measured/typical value; known flag strings are
+ * `"missing"`, `"substituted"`, and `"interpolated"` (kept as `string[]` so the
+ * backend can add flag kinds without a contract break).
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `timestamp` | `string` | Local ISO 8601 with offset, e.g. `"2026-06-21T14:00:00+05:30"` |
+ * | `utcOffsetMinutes` | `number` | UTC offset in minutes (restates the timestamp's offset) |
+ * | `dryBulbC` | `number` | Dry-bulb temperature, °C |
+ * | `relativeHumidityPercent` | `number` | Relative humidity, % |
+ * | `windSpeedMps` | `number` | Wind speed, m/s (at `source.windReferenceHeightM`) |
+ * | `ghiWm2` | `number` | Global horizontal irradiance, W/m² |
+ * | `dniWm2` | `number` | Direct normal irradiance, W/m² |
+ * | `dhiWm2` | `number` | Diffuse horizontal irradiance, W/m² |
+ * | `flags` | `string[]` | Quality flags; `[]` = clean value |
+ */
+export declare const PluginWeatherRow: z.ZodObject<{
+    timestamp: z.ZodString;
+    utcOffsetMinutes: z.ZodNumber;
+    dryBulbC: z.ZodNumber;
+    relativeHumidityPercent: z.ZodNumber;
+    windSpeedMps: z.ZodNumber;
+    ghiWm2: z.ZodNumber;
+    dniWm2: z.ZodNumber;
+    dhiWm2: z.ZodNumber;
+    flags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PluginWeatherRow = z.infer<typeof PluginWeatherRow>;
+/**
+ * Arguments for {@linkcode PluginAnalysisWeatherApi.getSeries}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `startDate` | `string` | Inclusive range start, ISO `"YYYY-MM-DD"` |
+ * | `endDate` | `string` | Inclusive range end, ISO `"YYYY-MM-DD"` |
+ * | `interval` | `"hourly"`? | Sampling interval; `"hourly"` is the only v1 value |
+ * | `cursor` | `string`? | Paging cursor from a prior page's `nextCursor` |
+ */
+export declare const PluginWeatherGetSeriesArgs: z.ZodObject<{
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    interval: z.ZodOptional<z.ZodEnum<{
+        hourly: "hourly";
+    }>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginWeatherGetSeriesArgs = z.infer<typeof PluginWeatherGetSeriesArgs>;
+/**
+ * Result of {@linkcode PluginAnalysisWeatherApi.getSeries} — one page.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `source` | {@linkcode PluginWeatherSourceMeta} | The resolved weather file's provenance |
+ * | `rows` | {@linkcode PluginWeatherRow}`[]` | Weather rows for this page |
+ * | `nextCursor` | `string \| null` | Pass back as `args.cursor`; `null` = last page |
+ * | `warnings` | `string[]`? | Degradation notices (e.g. `"override lookup failed; served nearest-station"`); omitted when the page is clean |
+ */
+export declare const PluginWeatherSeriesResult: z.ZodObject<{
+    source: z.ZodObject<{
+        weatherFileId: z.ZodString;
+        station: z.ZodString;
+        sourceId: z.ZodString;
+        distanceKm: z.ZodNullable<z.ZodNumber>;
+        selectionMethod: z.ZodEnum<{
+            "nearest-station": "nearest-station";
+            "user-upload": "user-upload";
+            "project-override": "project-override";
+        }>;
+        checksum: z.ZodString;
+        windReferenceHeightM: z.ZodNumber;
+    }, z.core.$strip>;
+    rows: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        utcOffsetMinutes: z.ZodNumber;
+        dryBulbC: z.ZodNumber;
+        relativeHumidityPercent: z.ZodNumber;
+        windSpeedMps: z.ZodNumber;
+        ghiWm2: z.ZodNumber;
+        dniWm2: z.ZodNumber;
+        dhiWm2: z.ZodNumber;
+        flags: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PluginWeatherSeriesResult = z.infer<typeof PluginWeatherSeriesResult>;
+//# sourceMappingURL=weather.d.ts.map

package/dist/api/analysis/weather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.d.ts","sourceRoot":"","sources":["../../../src/api/analysis/weather.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,wBAAwB;;IAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;aACa,SAAS,CACvB,IAAI,EAAE,0BAA0B,GAC/B,eAAe,CAAC,yBAAyB,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;EAIvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,4BAA4B,CACpC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAQlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAU3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;;;;;iBAKrC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAA"}

package/dist/api/core/camera/index.d.ts

@@ -115,6 +115,43 @@ export declare abstract class PluginCameraApi {
      * ```
      */
     abstract setProjection(projection: PluginCameraProjection): PluginApiReturn<boolean>;
+    /**
+     * Zoom (fit) the camera to all geometry in the scene — the "zoom extents"
+     * action. View-state only — not undoable. Canonical home of the zoom-extents
+     * read (the deprecated `core.zoom.extents`).
+     *
+     * @returns `true` once the camera has been framed to the scene.
+     *
+     * @examplePrompt Zoom out so I can see the whole model
+     * @examplePrompt Fit everything in the view
+     * @examplePrompt Frame the entire building in the viewport
+     * @examplePrompt Do a zoom extents on the canvas
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.core.camera.zoomExtents()
+     * ```
+     */
+    abstract zoomExtents(): PluginApiReturn<boolean>;
+    /**
+     * Zoom (fit) the camera to the current selection. View-state only — not
+     * undoable. Canonical home of the zoom-to-selection read (the deprecated
+     * `core.zoom.selection`).
+     *
+     * @returns `true` if there was a selection to frame; `false` if nothing is
+     *   selected (no-op).
+     *
+     * @examplePrompt Zoom in on what I have selected
+     * @examplePrompt Frame the selected walls in the view
+     * @examplePrompt Focus the camera on my current selection
+     * @examplePrompt Fit the view to the selected room
+     *
+     * # Example
+     * ```ts
+     * await snaptrude.core.camera.zoomSelection()
+     * ```
+     */
+    abstract zoomSelection(): PluginApiReturn<boolean>;
 }
 /**
  * A standard camera view: the five orthographic elevations (`top`/`front`/

package/dist/api/core/camera/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/camera/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;;;GAQG;AACH,8BAAsB,eAAe;;IAGnC;;;;;;;;;;;;;;;;;;OAkBG;aACa,QAAQ,CACtB,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,UAAU,GACjB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;aACa,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;OAiBG;aACa,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAC,OAAO,CAAC;IAEzE;;;;;;;;;;;;;;;;OAgBG;aACa,aAAa,IAAI,eAAe,CAAC,sBAAsB,CAAC;IAExE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,aAAa,CAC3B,UAAU,EAAE,sBAAsB,GACjC,eAAe,CAAC,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAAuB,CAAA;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;EAA0C,CAAA;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;iBAE1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;iBAExC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,6BAA6B,CACrC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/camera/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;;;GAQG;AACH,8BAAsB,eAAe;;IAGnC;;;;;;;;;;;;;;;;;;OAkBG;aACa,QAAQ,CACtB,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,UAAU,GACjB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;aACa,eAAe,CAC7B,IAAI,EAAE,kBAAkB,GACvB,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;OAiBG;aACa,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAC,OAAO,CAAC;IAEzE;;;;;;;;;;;;;;;;OAgBG;aACa,aAAa,IAAI,eAAe,CAAC,sBAAsB,CAAC;IAExE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,aAAa,CAC3B,UAAU,EAAE,sBAAsB,GACjC,eAAe,CAAC,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;OAgBG;aACa,WAAW,IAAI,eAAe,CAAC,OAAO,CAAC;IAEvD;;;;;;;;;;;;;;;;;OAiBG;aACa,aAAa,IAAI,eAAe,CAAC,OAAO,CAAC;CAC1D;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAAuB,CAAA;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;EAA0C,CAAA;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;iBAE1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,+BAA+B,CACvC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;iBAElC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;;iBAExC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,6BAA6B,CACrC,CAAA"}