@phoundry/phials-plugin-sdk 1.0.0 → 1.0.1

package/command-types.generated.d.ts

@@ -257,6 +257,14 @@ interface Command {
 	 */
 	children?: Command[];
 
+	/**
+	 * Optional custom items for menu surfaces that present this command as a
+	 * submenu. Semantic children remain available to the Command Bar.
+	 */
+	submenuItems?: (
+		ctx: CommandContext,
+	) => import("phoundry-ui").MenuItem[];
+
 	// ─── Custom Rendering ─────────────────────────────────────────────────────
 
 	/**

package/events-types.generated.d.ts

@@ -37,7 +37,7 @@ interface EventSubscription {
  */
 type EventHandler<T = unknown> = (payload: T) => void | Promise<void>;
 
-/** Details column layout live-sync payload (ADR-0010). */
+/** Details column layout live-sync payload. */
 interface ColumnLayoutChangedPayload {
 	browsedPath: string;
 	savedViewsCount: number;

package/file-types.generated.d.ts

@@ -91,6 +91,7 @@ type SortOrder = "asc" | "desc";
 type ViewMode =
 	| "details"
 	| "thumbnails"
+	| "masonry"
 	| "column"
 	| "tree"
 	| "boards"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phoundry/phials-plugin-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Public plugin SDK contract for Phials",
   "type": "module",
   "types": "./phials-plugin-sdk.d.ts",

package/plugin-types.generated.d.ts

@@ -151,6 +151,12 @@ interface PreviewDestinationCapabilities {
 	embed?: boolean;
 }
 
+/** Intrinsic content dimensions reported by a thumbnail provider. */
+interface ThumbnailIntrinsicDimensions {
+	width: number;
+	height: number;
+}
+
 /**
  * Props passed to thumbnail components
  */
@@ -160,6 +166,10 @@ interface ThumbnailProviderProps {
 	size: number;
 	generatedSize?: number;
 	quality?: number;
+	/** Report meaningful rendered dimensions to hosts that support ratio-aware layouts. */
+	onIntrinsicDimensions?: (
+		dimensions: ThumbnailIntrinsicDimensions,
+	) => void;
 }
 
 /**
@@ -492,7 +502,7 @@ interface FileBrowserViewProvider {
 
 	/**
 	 * Default item size when a folder has no per-folder override (`itemSize` null).
-	 * Details family uses row-height ticks; thumbnails / gallery use grid ticks;
+	 * Details family uses row-height ticks; thumbnails / Masonry / gallery use grid ticks;
 	 * Boards uses its column-width ticks.
 	 */
 	defaultItemSizePreset?: ViewItemSizePreset;

package/public-contract.generated.d.ts

@@ -44,7 +44,7 @@ type PluginPathOutcome =
 			readonly path: string;
 			readonly status: "failed";
 			readonly failure: PluginFileFailure;
-		};
+	  };
 
 interface PluginDirectoryReadResult {
 	readonly entries: readonly FileEntry[];
@@ -61,7 +61,7 @@ type PluginBinaryWriteResult =
 	| {
 			readonly status: "conflict";
 			readonly actualRevision: string | null;
-		};
+	  };
 
 interface FolderSummary {
 	readonly path: string;
@@ -105,6 +105,7 @@ type WorkspaceFolderPropertyType =
 	| "text"
 	| "number"
 	| "date"
+	| "calendar"
 	| "boolean"
 	| "select"
 	| "multi-select"
@@ -117,6 +118,18 @@ type WorkspaceFolderPropertyType =
 
 type WorkspaceFolderPropertyValue = JsonValue;
 
+type WorkspaceFolderCalendarValue =
+	| {
+			readonly kind: "date";
+			readonly start: string;
+			readonly end?: string;
+	  }
+	| {
+			readonly kind: "datetime";
+			readonly start: string;
+			readonly end?: string;
+	  };
+
 interface WorkspaceFolderPropertyOption {
 	readonly id: string;
 	readonly name: string;
@@ -159,9 +172,7 @@ interface WorkspaceFolderPropertyWrite {
 
 interface WorkspaceFoldersAPI {
 	isWorkspaceFolder(path: string): Promise<boolean>;
-	getSchema(
-		workspaceFolderIdOrPath: string,
-	): Promise<WorkspaceFolderSchema>;
+	getSchema(workspaceFolderIdOrPath: string): Promise<WorkspaceFolderSchema>;
 	getPropertyValue(
 		file: WorkspaceFolderFileRef,
 		propertyId: string,
@@ -176,9 +187,22 @@ interface WorkspaceFoldersAPI {
 		values: readonly WorkspaceFolderPropertyWrite[],
 	): Promise<void>;
 	getTags(file: WorkspaceFolderFileRef): Promise<readonly string[]>;
-	setTags(file: WorkspaceFolderFileRef, tags: readonly string[]): Promise<void>;
+	setTags(
+		file: WorkspaceFolderFileRef,
+		tags: readonly string[],
+	): Promise<void>;
 	getRating(file: WorkspaceFolderFileRef): Promise<number | null>;
-	setRating(file: WorkspaceFolderFileRef, rating: number | null): Promise<void>;
+	setRating(
+		file: WorkspaceFolderFileRef,
+		rating: number | null,
+	): Promise<void>;
+	getCalendar(
+		file: WorkspaceFolderFileRef,
+	): Promise<WorkspaceFolderCalendarValue | null>;
+	setCalendar(
+		file: WorkspaceFolderFileRef,
+		value: WorkspaceFolderCalendarValue | null,
+	): Promise<void>;
 	listKnown(): Promise<readonly KnownWorkspaceFolder[]>;
 	openPage(
 		file: WorkspaceFolderFileRef,
@@ -205,11 +229,7 @@ type PluginDatabaseValue = JsonPrimitive | Uint8Array;
 interface PluginDatabaseSchemaOperations {
 	createTable(table: PluginTableDefinition): Promise<void>;
 	addColumn(table: string, column: PluginColumnDefinition): Promise<void>;
-	renameColumn(
-		table: string,
-		from: string,
-		to: string,
-	): Promise<void>;
+	renameColumn(table: string, from: string, to: string): Promise<void>;
 	dropColumn(table: string, column: string): Promise<void>;
 	createIndex(table: string, index: PluginIndexDefinition): Promise<void>;
 	dropIndex(table: string, index: string): Promise<void>;