refactor: use consistent names -- chart views & narrative charts

adminSiteClient/AdminSidebar.tsx

@@ -37,7 +37,7 @@ export const AdminSidebar = (): React.ReactElement => (
             {chartViewsFeatureEnabled && (
                 <li>
                     <Link to="/chartViews">
-                        <FontAwesomeIcon icon={faPanorama} /> Narrative views
+                        <FontAwesomeIcon icon={faPanorama} /> Narrative charts
                     </Link>
                 </li>
             )}

adminSiteClient/ChartEditor.ts

@@ -200,15 +200,15 @@ export class ChartEditor extends AbstractChartEditor<ChartEditorManager> {
             )
     }
 
-    async saveAsNarrativeView(): Promise<void> {
+    async saveAsChartView(): Promise<void> {
         const { patchConfig, grapher } = this
 
         const chartJson = omit(patchConfig, CHART_VIEW_PROPS_TO_OMIT)
 
         const suggestedName = grapher.title ? slugify(grapher.title) : undefined
 
         const name = prompt(
-            "Please enter a programmatic name for the narrative view. Note that this name cannot be changed later.",
+            "Please enter a programmatic name for the narrative chart. Note that this name cannot be changed later.",
             suggestedName
         )
 

adminSiteClient/ChartViewIndexPage.tsx

@@ -134,7 +134,7 @@ export function ChartViewIndexPage() {
     }, [admin])
 
     return (
-        <AdminLayout title="Narrative views">
+        <AdminLayout title="Narrative charts">
             <main className="ChartViewIndexPage">
                 <Flex justify="space-between">
                     <Input

adminSiteClient/EditorReferencesTab.tsx

@@ -127,7 +127,7 @@ export const ReferencesSection = (props: {
 
     const chartViews = !!props.references?.chartViews?.length && (
         <>
-            <p>Narrative views based on this chart</p>
+            <p>Narrative charts based on this chart</p>
             <ul className="list-group">
                 {props.references.chartViews.map((chartView) => (
                     <li key={chartView.id} className="list-group-item">

adminSiteClient/SaveButtons.tsx

@@ -63,8 +63,8 @@ class SaveButtonsForChart extends React.Component<{
         void this.props.editor.saveAsNewGrapher()
     }
 
-    @action.bound onSaveAsNarrativeView() {
-        void this.props.editor.saveAsNarrativeView()
+    @action.bound onSaveAsChartView() {
+        void this.props.editor.saveAsChartView()
     }
 
     @action.bound onPublishToggle() {
@@ -122,10 +122,10 @@ class SaveButtonsForChart extends React.Component<{
                     <div className="mt-2">
                         <button
                             className="btn btn-primary"
-                            onClick={this.onSaveAsNarrativeView}
+                            onClick={this.onSaveAsChartView}
                             disabled={isSavingDisabled}
                         >
-                            Save as narrative view
+                            Save as narrative chart
                         </button>
                     </div>
                 )}

baker/SiteBaker.tsx

@@ -56,7 +56,7 @@ import {
     grabMetadataForGdocLinkedIndicator,
     TombstonePageData,
     gdocUrlRegex,
-    NarrativeViewInfo,
+    ChartViewInfo,
 } from "@ourworldindata/utils"
 import { execWrapper } from "../db/execWrapper.js"
 import { countryProfileSpecs } from "../site/countryProfileProjects.js"
@@ -110,7 +110,7 @@ import { getTombstones } from "../db/model/GdocTombstone.js"
 import { bakeAllMultiDimDataPages } from "./MultiDimBaker.js"
 import { getAllLinkedPublishedMultiDimDataPages } from "../db/model/MultiDimDataPage.js"
 import { getPublicDonorNames } from "../db/model/Donor.js"
-import { getNarrativeViewsInfo } from "../db/model/ChartView.js"
+import { getChartViewsInfo } from "../db/model/ChartView.js"
 
 type PrefetchedAttachments = {
     donors: string[]
@@ -122,7 +122,7 @@ type PrefetchedAttachments = {
         explorers: Record<string, LinkedChart>
     }
     linkedIndicators: Record<number, LinkedIndicator>
-    narrativeViewsInfo: Record<string, NarrativeViewInfo>
+    linkedChartViews: Record<string, ChartViewInfo>
 }
 
 // These aren't all "wordpress" steps
@@ -462,10 +462,10 @@ export class SiteBaker {
                 name: `✅ Prefetched ${publishedAuthors.length} authors`,
             })
 
-            const narrativeViewsInfo = await getNarrativeViewsInfo(knex)
-            const narrativeViewsInfoByName = keyBy(narrativeViewsInfo, "name")
+            const chartViewsInfo = await getChartViewsInfo(knex)
+            const chartViewsInfoByName = keyBy(chartViewsInfo, "name")
             this.progressBar.tick({
-                name: `✅ Prefetched ${narrativeViewsInfo.length} chart views`,
+                name: `✅ Prefetched ${chartViewsInfo.length} chart views`,
             })
 
             const prefetchedAttachments = {
@@ -478,7 +478,7 @@ export class SiteBaker {
                     graphers: publishedChartsBySlug,
                 },
                 linkedIndicators: datapageIndicatorsById,
-                narrativeViewsInfo: narrativeViewsInfoByName,
+                linkedChartViews: chartViewsInfoByName,
             }
             this.progressBar.tick({ name: "✅ Prefetched attachments" })
             this._prefetchedAttachmentsCache = prefetchedAttachments
@@ -490,7 +490,7 @@ export class SiteBaker {
                 imageFilenames,
                 linkedGrapherSlugs,
                 linkedExplorerSlugs,
-                linkedNarrativeChartNames,
+                linkedChartViewNames,
             ] = picks
             const linkedDocuments = pick(
                 this._prefetchedAttachmentsCache.linkedDocuments,
@@ -539,9 +539,9 @@ export class SiteBaker {
                     this._prefetchedAttachmentsCache.linkedAuthors.filter(
                         (author) => authorNames.includes(author.name)
                     ),
-                narrativeViewsInfo: pick(
-                    this._prefetchedAttachmentsCache.narrativeViewsInfo,
-                    linkedNarrativeChartNames
+                linkedChartViews: pick(
+                    this._prefetchedAttachmentsCache.linkedChartViews,
+                    linkedChartViewNames
                 ),
             }
         }
@@ -634,7 +634,7 @@ export class SiteBaker {
                 publishedGdoc.linkedImageFilenames,
                 publishedGdoc.linkedChartSlugs.grapher,
                 publishedGdoc.linkedChartSlugs.explorer,
-                publishedGdoc.linkedNarrativeChartNames,
+                publishedGdoc.linkedChartViewNames,
             ])
             publishedGdoc.donors = attachments.donors
             publishedGdoc.linkedAuthors = attachments.linkedAuthors
@@ -645,7 +645,7 @@ export class SiteBaker {
                 ...attachments.linkedCharts.explorers,
             }
             publishedGdoc.linkedIndicators = attachments.linkedIndicators
-            publishedGdoc.narrativeViewsInfo = attachments.narrativeViewsInfo
+            publishedGdoc.linkedChartViews = attachments.linkedChartViews
 
             // this is a no-op if the gdoc doesn't have an all-chart block
             if ("loadRelatedCharts" in publishedGdoc) {
@@ -893,7 +893,7 @@ export class SiteBaker {
                 dataInsight.linkedImageFilenames,
                 dataInsight.linkedChartSlugs.grapher,
                 dataInsight.linkedChartSlugs.explorer,
-                dataInsight.linkedNarrativeChartNames,
+                dataInsight.linkedChartViewNames,
             ])
             dataInsight.linkedDocuments = attachments.linkedDocuments
             dataInsight.imageMetadata = {
@@ -967,7 +967,7 @@ export class SiteBaker {
                 publishedAuthor.linkedImageFilenames,
                 publishedAuthor.linkedChartSlugs.grapher,
                 publishedAuthor.linkedChartSlugs.explorer,
-                publishedAuthor.linkedNarrativeChartNames,
+                publishedAuthor.linkedChartViewNames,
             ])
 
             // We don't need these to be attached to the gdoc in the current

baker/siteRenderers.tsx

@@ -439,7 +439,7 @@ ${dataInsights
                     latestDataInsights: get(post, "latestDataInsights", []),
                     homepageMetadata: get(post, "homepageMetadata", {}),
                     latestWorkLinks: get(post, "latestWorkLinks", []),
-                    narrativeViewsInfo: get(post, "narrativeViewsInfo", {}),
+                    linkedChartViews: get(post, "linkedChartViews", {}),
                 }}
             >
                 <AtomArticleBlocks blocks={post.content.body} />

db/migration/1734454799588-PostsGdocsLinksAddNarrativeCharts.ts → db/migration/1734454799588-PostsGdocsLinksAddChartViews.ts

@@ -1,12 +1,12 @@
 import { MigrationInterface, QueryRunner } from "typeorm"
 
-export class PostsGdocsLinksAddNarrativeCharts1734454799588
+export class PostsGdocsLinksAddChartViews1734454799588
     implements MigrationInterface
 {
     public async up(queryRunner: QueryRunner): Promise<void> {
         await queryRunner.query(`
             ALTER TABLE posts_gdocs_links
-            MODIFY linkType ENUM ('gdoc', 'url', 'grapher', 'explorer', 'narrative-chart') NULL`)
+            MODIFY linkType ENUM ('gdoc', 'url', 'grapher', 'explorer', 'chart-view') NULL`)
     }
 
     public async down(queryRunner: QueryRunner): Promise<void> {

db/model/ChartView.ts

@@ -1,11 +1,11 @@
-import { NarrativeViewInfo, JsonString } from "@ourworldindata/types"
+import { ChartViewInfo, JsonString } from "@ourworldindata/types"
 import * as db from "../db.js"
 
-export const getNarrativeViewsInfo = async (
+export const getChartViewsInfo = async (
     knex: db.KnexReadonlyTransaction,
     names?: string[]
-): Promise<NarrativeViewInfo[]> => {
-    type RawRow = Omit<NarrativeViewInfo, "queryParamsForParentChart"> & {
+): Promise<ChartViewInfo[]> => {
+    type RawRow = Omit<ChartViewInfo, "queryParamsForParentChart"> & {
         queryParamsForParentChart: JsonString
     }
     let rows: RawRow[]

db/model/Gdoc/GdocBase.ts

@@ -48,15 +48,15 @@ import {
     getVariableMetadata,
     getVariableOfDatapageIfApplicable,
 } from "../Variable.js"
-import { createLinkForNarrativeChart, createLinkFromUrl } from "../Link.js"
+import { createLinkForChartView, createLinkFromUrl } from "../Link.js"
 import {
     getMultiDimDataPageBySlug,
     isMultiDimDataPagePublished,
 } from "../MultiDimDataPage.js"
 import {
     ARCHVED_THUMBNAIL_FILENAME,
     ChartConfigType,
-    NarrativeViewInfo,
+    ChartViewInfo,
     DEFAULT_THUMBNAIL_FILENAME,
     GrapherInterface,
     LatestDataInsight,
@@ -67,7 +67,7 @@ import {
     OwidGdocLinkType,
     OwidGdocType,
 } from "@ourworldindata/types"
-import { getNarrativeViewsInfo } from "../ChartView.js"
+import { getChartViewsInfo } from "../ChartView.js"
 
 export class GdocBase implements OwidGdocBaseInterface {
     id!: string
@@ -91,7 +91,7 @@ export class GdocBase implements OwidGdocBaseInterface {
     linkedIndicators: Record<number, LinkedIndicator> = {}
     linkedDocuments: Record<string, OwidGdocMinimalPostInterface> = {}
     latestDataInsights: LatestDataInsight[] = []
-    narrativeViewsInfo?: Record<string, NarrativeViewInfo> = {}
+    linkedChartViews?: Record<string, ChartViewInfo> = {}
     _omittableFields: string[] = []
 
     constructor(id?: string) {
@@ -295,9 +295,9 @@ export class GdocBase implements OwidGdocBaseInterface {
         return { grapher: [...grapher], explorer: [...explorer] }
     }
 
-    get linkedNarrativeChartNames(): string[] {
+    get linkedChartViewNames(): string[] {
         const filteredLinks = this.links
-            .filter((link) => link.linkType === "narrative-chart")
+            .filter((link) => link.linkType === OwidGdocLinkType.ChartView)
             .map((link) => link.target)
 
         return filteredLinks
@@ -350,7 +350,7 @@ export class GdocBase implements OwidGdocBaseInterface {
                 }),
             ])
             .with({ type: "narrative-chart" }, (block) => [
-                createLinkForNarrativeChart({
+                createLinkForChartView({
                     name: block.name,
                     source: this,
                     componentType: block.type,
@@ -718,14 +718,9 @@ export class GdocBase implements OwidGdocBaseInterface {
         }
     }
 
-    async loadNarrativeViewsInfo(
-        knex: db.KnexReadonlyTransaction
-    ): Promise<void> {
-        const result = await getNarrativeViewsInfo(
-            knex,
-            this.linkedNarrativeChartNames
-        )
-        this.narrativeViewsInfo = keyBy(result, "name")
+    async loadChartViewsInfo(knex: db.KnexReadonlyTransaction): Promise<void> {
+        const result = await getChartViewsInfo(knex, this.linkedChartViewNames)
+        this.linkedChartViews = keyBy(result, "name")
     }
 
     async fetchAndEnrichGdoc(): Promise<void> {
@@ -873,7 +868,7 @@ export class GdocBase implements OwidGdocBaseInterface {
         await this.loadImageMetadataFromDB(knex)
         await this.loadLinkedCharts(knex)
         await this.loadLinkedIndicators() // depends on linked charts
-        await this.loadNarrativeViewsInfo(knex)
+        await this.loadChartViewsInfo(knex)
         await this._loadSubclassAttachments(knex)
         await this.validate(knex)
     }

db/model/Link.ts

@@ -63,7 +63,7 @@ export function createLinkFromUrl({
     } satisfies DbInsertPostGdocLink
 }
 
-export function createLinkForNarrativeChart({
+export function createLinkForChartView({
     name,
     source,
     componentType,
@@ -74,7 +74,7 @@ export function createLinkForNarrativeChart({
 }): DbInsertPostGdocLink {
     return {
         target: name,
-        linkType: OwidGdocLinkType.NarrativeChart,
+        linkType: OwidGdocLinkType.ChartView,
         queryString: "",
         hash: "",
         text: "",

packages/@ourworldindata/grapher/src/core/GrapherConstants.ts

@@ -5,8 +5,8 @@ import type { GrapherProgrammaticInterface } from "./Grapher"
 export const GRAPHER_EMBEDDED_FIGURE_ATTR = "data-grapher-src"
 export const GRAPHER_EMBEDDED_FIGURE_CONFIG_ATTR = "data-grapher-config"
 
-export const GRAPHER_VIEW_EMBEDDED_FIGURE_CONFIG_ATTR =
-    "data-grapher-view-config"
+export const GRAPHER_CHART_VIEW_EMBEDDED_FIGURE_CONFIG_ATTR =
+    "data-grapher-chart-view-config"
 
 export const GRAPHER_PAGE_BODY_CLASS = "StandaloneGrapherOrExplorerPage"
 export const GRAPHER_IS_IN_IFRAME_CLASS = "IsInIframe"

packages/@ourworldindata/grapher/src/index.ts

@@ -10,7 +10,7 @@ export { ChartDimension } from "./chart/ChartDimension"
 export {
     GRAPHER_EMBEDDED_FIGURE_ATTR,
     GRAPHER_EMBEDDED_FIGURE_CONFIG_ATTR,
-    GRAPHER_VIEW_EMBEDDED_FIGURE_CONFIG_ATTR,
+    GRAPHER_CHART_VIEW_EMBEDDED_FIGURE_CONFIG_ATTR,
     GRAPHER_PAGE_BODY_CLASS,
     GRAPHER_IS_IN_IFRAME_CLASS,
     DEFAULT_GRAPHER_WIDTH,

packages/@ourworldindata/types/src/gdocTypes/Gdoc.ts

@@ -55,7 +55,7 @@ export interface LinkedChart {
 }
 
 // An object containing metadata needed for embedded narrative charts
-export interface NarrativeViewInfo {
+export interface ChartViewInfo {
     name: string
     title: string
     chartConfigId: string
@@ -281,7 +281,7 @@ export enum OwidGdocLinkType {
     Url = "url",
     Grapher = "grapher",
     Explorer = "explorer",
-    NarrativeChart = "narrative-chart",
+    ChartView = "chart-view",
 }
 
 export interface OwidGdocLinkJSON {

packages/@ourworldindata/types/src/index.ts

@@ -332,7 +332,7 @@ export {
     type OwidGdocContent,
     type OwidGdocIndexItem,
     extractGdocIndexItem,
-    type NarrativeViewInfo,
+    type ChartViewInfo,
 } from "./gdocTypes/Gdoc.js"
 
 export {