From 56b77fdeca7f624ffc4d45d79a46be56ad27539b Mon Sep 17 00:00:00 2001 From: Thomas Plumpton Date: Fri, 27 Jun 2025 08:30:45 +0100 Subject: [PATCH 1/2] chore(docs): Added anchor links in component prop tables --- README.md | 121 ++++++++++++++++++------------------- packages/library/README.md | 120 ++++++++++++++++++------------------ 2 files changed, 120 insertions(+), 121 deletions(-) diff --git a/README.md b/README.md index 0a89f74..afc55db 100644 --- a/README.md +++ b/README.md @@ -234,18 +234,18 @@ Only the core parent components have required props. #### GitLog -| Prop | Type | Description | -|-----------------|-----------------|-------------------------------------------------------| -| `entries` | `GitLogEntry[]` | The git log entries to visualize on the graph. | -| `currentBranch` | `string` | The name of the branch that is currently checked out. | +| Prop | Type | Description | +|-----------------|----------------------------------|-------------------------------------------------------| +| `entries` | [`GitLogEntry[]`](#git-log-data) | The git log entries to visualize on the graph. | +| `currentBranch` | `string` | The name of the branch that is currently checked out. | #### GitLogPaged -| Prop | Type | Description | -|------------------|-----------------|----------------------------------------------------------| -| `entries` | `GitLogEntry[]` | The git log entries to visualize on the graph. | -| `branchName` | `string` | The name of the branch whose entries are being rendered. | -| `headCommitHash` | `string` | The SHA1 commit hash of the HEAD commit of the branch. | +| Prop | Type | Description | +|------------------|----------------------------------|----------------------------------------------------------| +| `entries` | [`GitLogEntry[]`](#git-log-data) | The git log entries to visualize on the graph. | +| `branchName` | `string` | The name of the branch whose entries are being rendered. | +| `headCommitHash` | `string` | The SHA1 commit hash of the HEAD commit of the branch. | ## Optional @@ -253,42 +253,41 @@ All components have optional props to further configure the log. ### GitLog -| Property | Type | Description | -|--------------------------------|-----------------------------|-------------------------------------------------------------------------------------------------------------| -| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | -| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | -| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | -| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | -| `urls` | `GitLogUrlBuilder` | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | -| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | -| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | -| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | -| `enableSelectedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is selected (i.e. has been clicked on). | -| `enablePreviewedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is previewed (i.e. is hovered over). | -| `classes` | `GitLogStylingProps` | CSS classes for various elements to enable custom styling. | -| `paging` | `GitLogPaging` | Optional paging settings for displaying a subset of log entries. | -| `indexStatus` | `GitLogIndexStatus` | Renders information about added, deleted and modified files to the index pseudo-commit entry. | -| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | +| Property | Type | Description | +|--------------------------------|---------------------------------------------|-------------------------------------------------------------------------------------------------------------| +| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | +| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | +| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | +| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | +| `urls` | [`GitLogUrlBuilder`](#gitlogurlbuilder) | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | +| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | +| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | +| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | +| `enableSelectedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is selected (i.e. has been clicked on). | +| `enablePreviewedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is previewed (i.e. is hovered over). | +| `classes` | [`GitLogStylingProps`](#gitlogstylingprops) | CSS classes for various elements to enable custom styling. | +| `paging` | [`GitLogPaging`](#gitlogpaging) | Optional paging settings for displaying a subset of log entries. | +| `indexStatus` | [`GitLogIndexStatus`](#gitlogindexstatus) | Renders information about added, deleted and modified files to the index pseudo-commit entry. | +| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | ### GitLogPaged -| Property | Type | Description | -|---------------------|-----------------------------|-------------------------------------------------------------------------------------------------------------| -| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | -| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | -| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | -| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | -| `urls` | `GitLogUrlBuilder` | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | -| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | -| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | -| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | -| `classes` | `GitLogStylingProps` | CSS classes for various elements to enable custom styling. | -| `indexStatus` | `GitLogIndexStatus` | Renders information about added, deleted and modified files to the index pseudo-commit entry. | -| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | +| Property | Type | Description | +|---------------------|---------------------------------------------|-------------------------------------------------------------------------------------------------------------| +| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | +| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | +| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | +| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | +| `urls` | [`GitLogUrlBuilder`](#gitlogurlbuilder) | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | +| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | +| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | +| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | +| `classes` | [`GitLogStylingProps`](#gitlogstylingprops) | CSS classes for various elements to enable custom styling. | +| `indexStatus` | [`GitLogIndexStatus`](#gitlogindexstatus) | Renders information about added, deleted and modified files to the index pseudo-commit entry. | +| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | #### GitLogStylingProps - | Property | Type | Description | |-------------------|-----------------|--------------------------------------------------------------------------------| | `containerClass` | `string` | Class name for the wrapping `
` containing branches, graph, and log table. | @@ -324,25 +323,25 @@ Returns an object of type `GitLogUrls` with the following fields. ### GraphHTMLGrid -| Property | Type | Description | -|-------------------------------|---------------------|----------------------------------------------------------------------------------------------------------------| -| `showCommitNodeHashes` | `boolean` | Whether to show the commit hash next to nodes in the graph. | -| `showCommitNodeTooltips` | `boolean` | Whether to show tooltips when hovering over a commit node. | -| `nodeTheme` | `NodeTheme` | Theme applied to commit node elements in the graph. | -| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | -| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | -| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | -| `highlightedBackgroundHeight` | `number` | The height, in pixels, of the background colour of a row that is being previewed or has been selected. | -| `node` | `CustomCommitNode` | A function that returns a custom commit node implementation used by the graph. See [here](#customcommitnode). | +| Property | Type | Description | +|-------------------------------|-----------------------------------------|----------------------------------------------------------------------------------------------------------------| +| `showCommitNodeHashes` | `boolean` | Whether to show the commit hash next to nodes in the graph. | +| `showCommitNodeTooltips` | `boolean` | Whether to show tooltips when hovering over a commit node. | +| `nodeTheme` | `NodeTheme` | Theme applied to commit node elements in the graph. | +| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | +| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | +| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | +| `highlightedBackgroundHeight` | `number` | The height, in pixels, of the background colour of a row that is being previewed or has been selected. | +| `node` | [`CustomCommitNode`](#customcommitnode) | A function that returns a custom commit node implementation used by the graph. | ### GraphCanvas2D -| Property | Type | Description | -|--------------------------|---------------------|----------------------------------------------------------------------------------------------------------------| -| `nodeTheme` | `NodeTheme` | Theme applied to commit node elements in the graph. | -| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | -| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | -| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | +| Property | Type | Description | +|--------------------------|---------------------------|----------------------------------------------------------------------------------------------------------------| +| `nodeTheme` | [`NodeTheme`](#nodetheme) | Theme applied to commit node elements in the graph. | +| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | +| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | +| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | #### NodeTheme @@ -353,12 +352,12 @@ Returns an object of type `GitLogUrls` with the following fields. ### Table -| Property | Type | Description | -|-------------------|---------------------------|---------------------------------------------------------------------------------------------------------| -| `timestampFormat` | `string` | A timestamp format string for DayJS to format commit timestamps. Default: `ISO-8601`. | -| `className` | `string` | A class name for the table's wrapping container. | -| `styles` | `GitLogTableStylingProps` | A React CSS styling object for the table elements. | -| `row` | `CustomTableRow` | A function that returns a custom implementation for the table row element. See [here](#customtablerow). | +| Property | Type | Description | +|-------------------|-------------------------------------------------------|---------------------------------------------------------------------------------------| +| `timestampFormat` | `string` | A timestamp format string for DayJS to format commit timestamps. Default: `ISO-8601`. | +| `className` | `string` | A class name for the table's wrapping container. | +| `styles` | [`GitLogTableStylingProps`](#gitlogtablestylingprops) | A React CSS styling object for the table elements. | +| `row` | [`CustomTableRow`](#customtablerow) | A function that returns a custom implementation for the table row element.. | #### GitLogTableStylingProps diff --git a/packages/library/README.md b/packages/library/README.md index 3f379fe..917ad38 100644 --- a/packages/library/README.md +++ b/packages/library/README.md @@ -153,18 +153,18 @@ Only the core parent components have required props. #### GitLog -| Prop | Type | Description | -|-----------------|-----------------|-------------------------------------------------------| -| `entries` | `GitLogEntry[]` | The git log entries to visualize on the graph. | -| `currentBranch` | `string` | The name of the branch that is currently checked out. | +| Prop | Type | Description | +|-----------------|----------------------------------|-------------------------------------------------------| +| `entries` | [`GitLogEntry[]`](#git-log-data) | The git log entries to visualize on the graph. | +| `currentBranch` | `string` | The name of the branch that is currently checked out. | #### GitLogPaged -| Prop | Type | Description | -|------------------|-----------------|----------------------------------------------------------| -| `entries` | `GitLogEntry[]` | The git log entries to visualize on the graph. | -| `branchName` | `string` | The name of the branch whose entries are being rendered. | -| `headCommitHash` | `string` | The SHA1 commit hash of the HEAD commit of the branch. | +| Prop | Type | Description | +|------------------|----------------------------------|----------------------------------------------------------| +| `entries` | [`GitLogEntry[]`](#git-log-data) | The git log entries to visualize on the graph. | +| `branchName` | `string` | The name of the branch whose entries are being rendered. | +| `headCommitHash` | `string` | The SHA1 commit hash of the HEAD commit of the branch. | ## Optional @@ -172,38 +172,38 @@ All components have optional props to further configure the log. ### GitLog -| Property | Type | Description | -|--------------------------------|-----------------------------|-------------------------------------------------------------------------------------------------------------| -| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | -| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | -| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | -| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | -| `urls` | `GitLogUrlBuilder` | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | -| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | -| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | -| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | -| `enableSelectedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is selected (i.e. has been clicked on). | -| `enablePreviewedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is previewed (i.e. is hovered over). | -| `classes` | `GitLogStylingProps` | CSS classes for various elements to enable custom styling. | -| `paging` | `GitLogPaging` | Optional paging settings for displaying a subset of log entries. | -| `indexStatus` | `GitLogIndexStatus` | Renders information about added, deleted and modified files to the index pseudo-commit entry. | -| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | +| Property | Type | Description | +|--------------------------------|---------------------------------------------|-------------------------------------------------------------------------------------------------------------| +| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | +| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | +| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | +| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | +| `urls` | [`GitLogUrlBuilder`](#gitlogurlbuilder) | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | +| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | +| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | +| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | +| `enableSelectedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is selected (i.e. has been clicked on). | +| `enablePreviewedCommitStyling` | `boolean` | Enables the row styling across the log elements when a commit is previewed (i.e. is hovered over). | +| `classes` | [`GitLogStylingProps`](#gitlogstylingprops) | CSS classes for various elements to enable custom styling. | +| `paging` | [`GitLogPaging`](#gitlogpaging) | Optional paging settings for displaying a subset of log entries. | +| `indexStatus` | [`GitLogIndexStatus`](#gitlogindexstatus) | Renders information about added, deleted and modified files to the index pseudo-commit entry. | +| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | ### GitLogPaged -| Property | Type | Description | -|-----------------------|-----------------------------|-------------------------------------------------------------------------------------------------------------| -| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | -| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | -| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | -| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | -| `urls` | `GitLogUrlBuilder` | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | -| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | -| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | -| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | -| `classes` | `GitLogStylingProps` | CSS classes for various elements to enable custom styling. | -| `indexStatus` | `GitLogIndexStatus` | Renders information about added, deleted and modified files to the index pseudo-commit entry. | -| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | +| Property | Type | Description | +|---------------------|---------------------------------------------|-------------------------------------------------------------------------------------------------------------| +| `theme` | `ThemeMode` | The variant of the default color theme to apply to the log. | +| `colours` | `ThemeColours \| string[]` | Array of colors used for graph elements. One per column, looping if insufficient colors are provided. | +| `showHeaders` | `boolean` | Whether to show element names like "Graph" or "Commit message" at the top of the component. | +| `rowSpacing` | `number` | The spacing between log rows, affecting branches, graph, and table. Default: `0`. | +| `urls` | [`GitLogUrlBuilder`](#gitlogurlbuilder) | A function that returns built URLs to the remote Git provider. Enables links for commits, tags, and PRs. | +| `defaultGraphWidth` | `number` | Default width of the graph in pixels. Can be changed dynamically if resizing is enabled. Default: `300`. | +| `onSelectCommit` | `(commit?: Commit) => void` | Callback function when a commit is selected (clicked). `commit` is `undefined` if unselected. | +| `onPreviewCommit` | `(commit?: Commit) => void` | Callback function when a commit is previewed (hovered). `commit` is `undefined` if stopped being previewed. | +| `classes` | [`GitLogStylingProps`](#gitlogstylingprops) | CSS classes for various elements to enable custom styling. | +| `indexStatus` | [`GitLogIndexStatus`](#gitlogindexstatus) | Renders information about added, deleted and modified files to the index pseudo-commit entry. | +| `showGitIndex` | `boolean` | Enables the Git index "pseudo-commit' entry above the HEAD commit. | #### GitLogStylingProps @@ -242,25 +242,25 @@ Returns an object of type `GitLogUrls` with the following fields. ### GraphHTMLGrid -| Property | Type | Description | -|-------------------------------|---------------------|----------------------------------------------------------------------------------------------------------------| -| `showCommitNodeHashes` | `boolean` | Whether to show the commit hash next to nodes in the graph. | -| `showCommitNodeTooltips` | `boolean` | Whether to show tooltips when hovering over a commit node. | -| `nodeTheme` | `NodeTheme` | Theme applied to commit node elements in the graph. | -| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | -| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | -| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | -| `highlightedBackgroundHeight` | `number` | The height, in pixels, of the background colour of a row that is being previewed or has been selected. | -| `node` | `CustomCommitNode` | A function that returns a custom commit node implementation used by the graph. See [here](#customcommitnode). | +| Property | Type | Description | +|-------------------------------|-----------------------------------------|----------------------------------------------------------------------------------------------------------------| +| `showCommitNodeHashes` | `boolean` | Whether to show the commit hash next to nodes in the graph. | +| `showCommitNodeTooltips` | `boolean` | Whether to show tooltips when hovering over a commit node. | +| `nodeTheme` | `NodeTheme` | Theme applied to commit node elements in the graph. | +| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | +| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | +| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | +| `highlightedBackgroundHeight` | `number` | The height, in pixels, of the background colour of a row that is being previewed or has been selected. | +| `node` | [`CustomCommitNode`](#customcommitnode) | A function that returns a custom commit node implementation used by the graph. | ### GraphCanvas2D -| Property | Type | Description | -|--------------------------|---------------------|----------------------------------------------------------------------------------------------------------------| -| `nodeTheme` | `NodeTheme` | Theme applied to commit node elements in the graph. | -| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | -| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | -| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | +| Property | Type | Description | +|--------------------------|---------------------------|----------------------------------------------------------------------------------------------------------------| +| `nodeTheme` | [`NodeTheme`](#nodetheme) | Theme applied to commit node elements in the graph. | +| `nodeSize` | `number` | The diameter, in pixels, of the commits nodes. Should be divisible by 2 and between 8 and 30 to render nicely. | +| `orientation` | `normal \| flipped` | The orientation of the graph. Normal renders the checked-out branch on the left, flipped on the right. | +| `enableResize` | `boolean` | Enables horizontal resizing of the graph. Default: `false`. | #### NodeTheme @@ -271,12 +271,12 @@ Returns an object of type `GitLogUrls` with the following fields. ### Table -| Property | Type | Description | -|-------------------|---------------------------|---------------------------------------------------------------------------------------------------------| -| `timestampFormat` | `string` | A timestamp format string for DayJS to format commit timestamps. Default: `ISO-8601`. | -| `className` | `string` | A class name for the table's wrapping container. | -| `styles` | `GitLogTableStylingProps` | A React CSS styling object for the table elements. | -| `row` | `CustomTableRow` | A function that returns a custom implementation for the table row element. See [here](#customtablerow). | +| Property | Type | Description | +|-------------------|-------------------------------------------------------|---------------------------------------------------------------------------------------| +| `timestampFormat` | `string` | A timestamp format string for DayJS to format commit timestamps. Default: `ISO-8601`. | +| `className` | `string` | A class name for the table's wrapping container. | +| `styles` | [`GitLogTableStylingProps`](#gitlogtablestylingprops) | A React CSS styling object for the table elements. | +| `row` | [`CustomTableRow`](#customtablerow) | A function that returns a custom implementation for the table row element.. | #### GitLogTableStylingProps From cf624a0976813d3812723eb7e729468b7488be07 Mon Sep 17 00:00:00 2001 From: Thomas Plumpton Date: Fri, 27 Jun 2025 08:31:16 +0100 Subject: [PATCH 2/2] chore(ci): persisted production build files across jobs in release workflow --- .github/workflows/release.yml | 11 +++++++++++ package-lock.json | 2 +- packages/library/package.json | 2 +- 3 files changed, 13 insertions(+), 2 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 01ca564..5949aee 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -16,6 +16,11 @@ jobs: cache: 'npm' - run: npm install - run: npm run build --workspace=@tomplum/react-git-log + - name: Store Built Artifact + uses: actions/upload-artifact@v4 + with: + name: production-build + path: ./packages/library/dist build-storybook: runs-on: ubuntu-latest @@ -163,6 +168,12 @@ jobs: echo "VERSION_EXISTS=false" >> $GITHUB_ENV fi + - name: Download Production Build + uses: actions/download-artifact@v4 + with: + name: production-build + path: ./packages/library/dist + - name: Publish to NPM if: env.VERSION_EXISTS == 'false' run: npm publish --workspace=@tomplum/react-git-log --access public diff --git a/package-lock.json b/package-lock.json index e47b8a8..0e9edcc 100644 --- a/package-lock.json +++ b/package-lock.json @@ -11387,7 +11387,7 @@ }, "packages/library": { "name": "@tomplum/react-git-log", - "version": "3.4.1", + "version": "3.4.2", "license": "Apache-2.0", "dependencies": { "@uidotdev/usehooks": "^2.4.1", diff --git a/packages/library/package.json b/packages/library/package.json index 0c52126..3ade3df 100644 --- a/packages/library/package.json +++ b/packages/library/package.json @@ -3,7 +3,7 @@ "author": "Thomas Plumpton", "repository": "https://github.com/TomPlum/react-git-log", "description": "A flexible, themable, React component for visualising Git commit history, branch and tag metadata.", - "version": "3.4.1", + "version": "3.4.2", "license": "Apache-2.0", "type": "module", "main": "dist/react-git-log.js",