@doug-williamson/ng-rhombus 2.0.0-beta.3 → 2.0.0-beta.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doug-williamson/ng-rhombus",
-  "version": "2.0.0-beta.3",
+  "version": "2.0.0-beta.4",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",

package/types/doug-williamson-ng-rhombus.d.ts

@@ -159,7 +159,7 @@ type NgRhombusTimestampLike = Date | number | string | {
     nanoseconds?: number;
 };
 declare function ngRhombusTimestampToMillis(value: NgRhombusTimestampLike | null | undefined): number | null;
-declare enum ContentPillar {
+declare enum ContentDimension {
     DeveloperLife = "Developer Life",
     AngularWebEngineering = "Angular & Web Engineering",
     GamingAsAnAdult = "Gaming as an Adult",
@@ -174,33 +174,56 @@ declare enum BlogSeries {
     TradeoffsTruths = "Tradeoffs & Truths",
     FromTheEditor = "From The Editor"
 }
-declare class IBlog {
+type BlogPostStatus = 'draft' | 'queued' | 'published';
+interface BlogPostSocialLinks {
+    x?: string;
+    linkedin?: string;
+}
+interface BlogPost {
     id: string;
     title: string;
-    description: string;
-    thumbnail: string;
+    slug: string;
+    excerpt: string;
     content: string;
+    status: BlogPostStatus;
+    createdAt: NgRhombusTimestampLike;
+    updatedAt: NgRhombusTimestampLike;
+    publishAt?: NgRhombusTimestampLike;
+    publishedAt?: NgRhombusTimestampLike;
+    queueOrder?: number;
+    dimensions?: string[];
+    tags?: string[];
+    readingTime?: number;
+    social?: BlogPostSocialLinks;
     /**
-     * Published timestamp used for ordering.
-        * Kept flexible so apps can provide Firestore Timestamp, Date, millis, etc.
+     * Legacy/back-compat fields we still render in the UI.
+     * Keep optional to avoid breaking older documents before migration.
      */
-    timestamp: NgRhombusTimestampLike;
-    /** Estimated read time in minutes at 200 wpm */
-    readTimeMinutes: number;
+    thumbnail?: string;
+    description?: string;
     /**
-     * Creator system fields.
-     * Keep optional for backward compatibility; enforce required in admin UI + writes.
+     * Legacy single dimension field. Kept only for backward compatibility with older documents.
+     * New writes should use the dimensions[] array exclusively.
      */
-    pillar?: ContentPillar | null;
+    dimension?: ContentDimension | null;
+    /**
+     * Legacy pillars array. If present, map to dimensions.
+     */
+    pillars?: string[];
     series?: BlogSeries | null;
-    tags?: string[] | null;
+    timestamp?: NgRhombusTimestampLike;
 }
+type IBlog = BlogPost;
 
 declare class NgRhombusBlogListComponent implements OnInit {
     #private;
     goToRoute: EventEmitter<string>;
-    dataSource: i0.InputSignal<IBlog[]>;
+    dataSource: i0.InputSignal<_doug_williamson_ng_rhombus.BlogPost[]>;
     timestampToMillis: typeof ngRhombusTimestampToMillis;
+    hasDimensions(post: IBlog): boolean;
+    firstDimension(post: IBlog): string | undefined;
+    hasTaxonomy(post: IBlog): boolean;
+    getDisplayDate(post: IBlog): any;
     ngOnInit(): void;
     goToBlogPost(id: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgRhombusBlogListComponent, never>;
@@ -208,8 +231,9 @@ declare class NgRhombusBlogListComponent implements OnInit {
 }
 
 declare class NgRhombusBlogPostLatestComponent {
-    blogPost: i0.InputSignal<IBlog | undefined>;
+    blogPost: i0.InputSignal<_doug_williamson_ng_rhombus.BlogPost | undefined>;
     timestampToMillis: typeof ngRhombusTimestampToMillis;
+    getDisplayDate(post: IBlog | undefined): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgRhombusBlogPostLatestComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NgRhombusBlogPostLatestComponent, "ng-rhombus-blog-post-latest", never, { "blogPost": { "alias": "blogPost"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -217,12 +241,13 @@ declare class NgRhombusBlogPostLatestComponent {
 declare class NgRhombusBlogService {
     private readonly WORDS_PER_MINUTE;
     private readonly blogAdapter;
+    private normalizeDimensions;
     private normalizeBlogPost;
-    blogPosts: i0.WritableSignal<IBlog[]>;
-    selectedBlogPost: i0.WritableSignal<IBlog | undefined>;
-    fetchBlogPosts(): Promise<IBlog[]>;
-    fetchBlogPost(id: string): Promise<IBlog | undefined>;
-    fetchLatestBlogPost(): Promise<IBlog | undefined>;
+    blogPosts: i0.WritableSignal<_doug_williamson_ng_rhombus.BlogPost[]>;
+    selectedBlogPost: i0.WritableSignal<_doug_williamson_ng_rhombus.BlogPost | undefined>;
+    fetchBlogPosts(): Promise<_doug_williamson_ng_rhombus.BlogPost[]>;
+    fetchBlogPost(id: string): Promise<_doug_williamson_ng_rhombus.BlogPost | undefined>;
+    fetchLatestBlogPost(): Promise<_doug_williamson_ng_rhombus.BlogPost | undefined>;
     createBlogPost(blogPost: IBlog): Promise<void>;
     updateBlogPost(blogPost: IBlog): Promise<void>;
     deleteBlogPost(id: string): Promise<void>;
@@ -249,7 +274,20 @@ declare class NgRhombusBlogService {
         nextNewer?: IBlog;
         nextOlder?: IBlog;
     }>;
-    calculateReadTimeMinutes(text: string | null | undefined): number;
+    calculateReadingTime(text: string | null | undefined): number;
+    saveQueueOrder(queue: IBlog[]): Promise<void>;
+    primaryDimension(post: IBlog | undefined): string | null;
+    dimensionsOf(post: IBlog | undefined): string[];
+    private hasDimension;
+    private overlapDimensions;
+    fetchRelatedPosts(current: IBlog, opts?: {
+        primaryLimit?: number;
+        bridgeLimit?: number;
+    }): Promise<{
+        primary: IBlog[];
+        bridge?: IBlog | null;
+    }>;
+    private ensureSocialSnippet;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgRhombusBlogService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NgRhombusBlogService>;
 }
@@ -263,13 +301,16 @@ type BlogTableRow = {
 };
 declare class NgRhombusBlogTableComponent {
     editEvent: EventEmitter<string>;
-    deleteEvent: EventEmitter<IBlog>;
+    deleteEvent: EventEmitter<_doug_williamson_ng_rhombus.BlogPost>;
     readonly blogService: NgRhombusBlogService;
     readonly dialog: MatDialog;
-    dataSource: i0.InputSignal<IBlog[]>;
+    dataSource: i0.InputSignal<_doug_williamson_ng_rhombus.BlogPost[]>;
     timestampToMillis: typeof ngRhombusTimestampToMillis;
+    hasDimensions(post: IBlog): boolean;
+    firstDimension(post: IBlog): string | undefined;
     displayedColumns: string[];
     detailColumns: string[];
+    getDisplayDate(post: IBlog): any;
     tableData(): BlogTableRow[];
     isMainRow: (_index: number, row: BlogTableRow) => row is {
         kind: "main";
@@ -315,12 +356,13 @@ declare class ThemeService {
 
 declare class NgRhombusBlogAddEditComponent {
     themeService: ThemeService;
-    blogPost: i0.InputSignal<IBlog | undefined>;
+    blogPost: i0.InputSignal<_doug_williamson_ng_rhombus.BlogPost | undefined>;
     cancelEvent: i0.OutputEmitterRef<void>;
-    submitEvent: i0.OutputEmitterRef<IBlog>;
+    submitEvent: i0.OutputEmitterRef<_doug_williamson_ng_rhombus.BlogPost>;
     contentData: i0.WritableSignal<string>;
     blogPostForm: FormGroup;
-    readonly pillars: ContentPillar[];
+    private readonly dimensionRequiredValidator;
+    readonly dimensions: ContentDimension[];
     readonly seriesOptions: BlogSeries[];
     dialog: MatDialog;
     thumbnailService: NgRhombusBlogPostThumbnailService;
@@ -333,8 +375,8 @@ declare class NgRhombusBlogAddEditComponent {
     private applyCreatorSystemRules;
     onContentChange(): void;
     get thumbnailSource(): any;
-    onFileUploaded(downloadUrl: string): void;
-    onFileDeleted(): void;
+    onFileUploaded(downloadUrl: string): Promise<void>;
+    onFileDeleted(): Promise<void>;
     onCancelClick(): void;
     onSubmit(): void;
     private parseTags;
@@ -344,9 +386,10 @@ declare class NgRhombusBlogAddEditComponent {
 
 declare class NgRhombusBlogPostComponent implements OnInit {
     #private;
-    dataSource: i0.InputSignal<IBlog | undefined>;
+    dataSource: i0.InputSignal<_doug_williamson_ng_rhombus.BlogPost | undefined>;
     themeService: ThemeService;
     timestampToMillis: typeof ngRhombusTimestampToMillis;
+    getDisplayDate(post: IBlog | undefined): any;
     ngOnInit(): void;
     getShareUrl(): string;
     get shareLinks(): {
@@ -361,10 +404,11 @@ declare class NgRhombusBlogPostComponent implements OnInit {
     faBluesky: _fortawesome_fontawesome_common_types.IconDefinition;
     faLinkedin: _fortawesome_fontawesome_common_types.IconDefinition;
     private normalizeTags;
-    get contentPillar(): string | null;
+    get contentDimensions(): string[];
     get series(): string | null;
     get tags(): string[];
     get hasTaxonomy(): boolean;
+    private normalizeDimensions;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgRhombusBlogPostComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NgRhombusBlogPostComponent, "ng-rhombus-blog-post", never, { "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -390,7 +434,15 @@ interface NgRhombusBlogAdapter {
         nextOlder?: IBlog;
     }>;
     createBlogPost(blogPost: IBlog): Promise<void>;
-    updateBlogPost(blogPost: IBlog): Promise<void>;
+    updateBlogPost(blogPost: Partial<IBlog> & {
+        id: string;
+    }): Promise<void>;
+    /** Batch helper for queue reordering; optional for adapters that cannot batch. */
+    updateQueueOrder?(queue: {
+        id: string;
+        queueOrder?: number;
+        status?: IBlog['status'];
+    }[]): Promise<void>;
     deleteBlogPost(id: string): Promise<void>;
 }
 declare const NG_RHOMBUS_BLOG_ADAPTER: InjectionToken<NgRhombusBlogAdapter>;
@@ -504,5 +556,5 @@ interface NgRhombusSocialsAdapter {
 }
 declare const NG_RHOMBUS_SOCIALS_ADAPTER: InjectionToken<NgRhombusSocialsAdapter>;
 
-export { BlogSeries, ContentPillar, IBlog, IHome, NG_RHOMBUS_AUTH_ADAPTER, NG_RHOMBUS_BLOG_ADAPTER, NG_RHOMBUS_BLOG_THUMBNAIL_ADAPTER, NG_RHOMBUS_HOME_ADAPTER, NG_RHOMBUS_SEO_ADAPTER, NG_RHOMBUS_SITE_METADATA, NG_RHOMBUS_SOCIALS_ADAPTER, NgRhombusBlogAddEditComponent, NgRhombusBlogDeletePostComponent, NgRhombusBlogListComponent, NgRhombusBlogPostComponent, NgRhombusBlogPostLatestComponent, NgRhombusBlogPostThumbnailService, NgRhombusBlogService, NgRhombusBlogTableComponent, NgRhombusHomeAdminComponent, NgRhombusHomeService, NgRhombusLoginComponent, NgRhombusMarkdownComponent, NgRhombusPageComponent, NgRhombusSocialsListComponent, NgRhombusSocialsService, NgRhombusSocialsTableComponent, NgRhombusSpinnerComponent, NgRhombusWrapperComponent, SocialsSource, ThemeEnum, WrapperService, ngRhombusTimestampToMillis };
-export type { Breadcrumb, ILoginCredentials, ISocial, NgRhombusAuthAdapter, NgRhombusAuthUser, NgRhombusBlogAdapter, NgRhombusBlogThumbnailAdapter, NgRhombusHomeAdapter, NgRhombusHomeSaveResult, NgRhombusNavItem, NgRhombusSeoAdapter, NgRhombusSeoTag, NgRhombusSiteMetadata, NgRhombusSocialsAdapter, NgRhombusTimestampLike, Theme };
+export { BlogSeries, ContentDimension, IHome, NG_RHOMBUS_AUTH_ADAPTER, NG_RHOMBUS_BLOG_ADAPTER, NG_RHOMBUS_BLOG_THUMBNAIL_ADAPTER, NG_RHOMBUS_HOME_ADAPTER, NG_RHOMBUS_SEO_ADAPTER, NG_RHOMBUS_SITE_METADATA, NG_RHOMBUS_SOCIALS_ADAPTER, NgRhombusBlogAddEditComponent, NgRhombusBlogDeletePostComponent, NgRhombusBlogListComponent, NgRhombusBlogPostComponent, NgRhombusBlogPostLatestComponent, NgRhombusBlogPostThumbnailService, NgRhombusBlogService, NgRhombusBlogTableComponent, NgRhombusHomeAdminComponent, NgRhombusHomeService, NgRhombusLoginComponent, NgRhombusMarkdownComponent, NgRhombusPageComponent, NgRhombusSocialsListComponent, NgRhombusSocialsService, NgRhombusSocialsTableComponent, NgRhombusSpinnerComponent, NgRhombusWrapperComponent, SocialsSource, ThemeEnum, WrapperService, ngRhombusTimestampToMillis };
+export type { BlogPost, BlogPostSocialLinks, BlogPostStatus, Breadcrumb, IBlog, ILoginCredentials, ISocial, NgRhombusAuthAdapter, NgRhombusAuthUser, NgRhombusBlogAdapter, NgRhombusBlogThumbnailAdapter, NgRhombusHomeAdapter, NgRhombusHomeSaveResult, NgRhombusNavItem, NgRhombusSeoAdapter, NgRhombusSeoTag, NgRhombusSiteMetadata, NgRhombusSocialsAdapter, NgRhombusTimestampLike, Theme };