@servicetitan/anvil2-ext-common 0.0.0-rc-1.49.0-20251112153304 → 0.0.0-rc-1.49.0-20251114220804

package/CHANGELOG.md

@@ -1,11 +1,25 @@
 # @servicetitan/anvil2-ext-common
 
-## 0.0.0-rc-1.49.0-20251112153304
+## 0.0.0-rc-1.49.0-20251114220804
 
 ### Patch Changes
 
-- Updated dependencies [[`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1), [`eec7556`](https://github.com/servicetitan/hammer/commit/eec75569f008fa2df8166b8efd5c5975741ad386), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1)]:
-  - @servicetitan/anvil2@0.0.0-rc-1.49.0-20251112153304
+- Updated dependencies [[`f76f28c`](https://github.com/servicetitan/hammer/commit/f76f28cfbb4a6fde0a4de1854181deae72a5cd26), [`f463031`](https://github.com/servicetitan/hammer/commit/f463031c7f023153157cc49b57534035e0745b71), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1), [`9fee6b2`](https://github.com/servicetitan/hammer/commit/9fee6b2155d80d8e5d1a4175e0da51160b8ae681), [`9fee6b2`](https://github.com/servicetitan/hammer/commit/9fee6b2155d80d8e5d1a4175e0da51160b8ae681), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1), [`138b5d2`](https://github.com/servicetitan/hammer/commit/138b5d2c868da26258622fbcd829a7a2923b32ab), [`b92e48b`](https://github.com/servicetitan/hammer/commit/b92e48bd0b2720a49fb8fb0078477effafde20c1)]:
+  - @servicetitan/anvil2@0.0.0-rc-1.49.0-20251114220804
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [[`834507e`](https://github.com/servicetitan/hammer/commit/834507e1ae1b11d46db95131849258f583a59eea), [`7889423`](https://github.com/servicetitan/hammer/commit/788942353ece5412f6c4c7382907489d9861d068), [`7889423`](https://github.com/servicetitan/hammer/commit/788942353ece5412f6c4c7382907489d9861d068), [`ef457b3`](https://github.com/servicetitan/hammer/commit/ef457b36b15049080c4b7a86024a1a955c10fc0f), [`a46d097`](https://github.com/servicetitan/hammer/commit/a46d097bd7b8153aed09bdfd717029e231d4ac0b), [`4a70c88`](https://github.com/servicetitan/hammer/commit/4a70c88392905b3c3de55715eb8d0af05f2f3eef)]:
+  - @servicetitan/anvil2@1.48.0
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [[`eec7556`](https://github.com/servicetitan/hammer/commit/eec75569f008fa2df8166b8efd5c5975741ad386)]:
+  - @servicetitan/anvil2@1.47.1
 
 ## 0.1.5
 

package/README.md

@@ -0,0 +1,159 @@
+<h1 align="center">
+  Anvil2 Extended Common
+</h1>
+
+The Anvil2 Extended Common library is an open contribution area for components, hooks, and other code that extends Anvil2. This is maintained by the larger ServiceTitan engineering organization with support from the Design System team.
+
+# Getting Started
+
+## Installation
+
+We recommend installing the Common package by running the following `npm` command (or the equivalent `yarn`/`pnpm` command) in your project folder:
+
+```
+npm install @servicetitan/anvil2-ext-common
+```
+
+> [!NOTE]
+> This package requires `@servicetitan/anvil2` as a `peerDependency`, so make sure that is installed as well, and meets the version requirement in this package's `package.json`.
+
+## Usage
+
+Components and hooks can be imported as named exports from the package root:
+
+```tsx
+import { useConfirmDialog } from "@servicetitan/anvil2-ext-common";
+```
+
+<br />
+
+# Contribution Guide
+
+This extended common library is meant to be a place for contributions that extend the Anvil2 library, but that don't necessarily make sense to live inside of Anvil2. Do you have a wrapper to connect a component to MobX or formstate or to a specific backend API? Do you have a shorthand to reduce the boilerplate for one of your common use cases? This is the place for those kinds of contributions!
+
+This library can also be used as a place to test new ideas and features that are proposed to be added to Anvil2 in the future, but that need more validation or testing. Code in the common library is not required to be 100% stable to allow for these kind of experimental contributions and to serve as a more open area for testing ideas.
+
+The Design System team intends to give guidance and help with maintaining contributions here, but contributions to this package aren't intended to meet the same standards as Anvil2 code.
+
+## Prerequisites
+
+This monorepo requires Node >= 20 and [pnpm](https://pnpm.io/) >= 9.
+<br />
+To install `pnpm`, please follow the installation instructions at: https://pnpm.io/installation
+
+## Setting up your local repo
+
+Install the dependencies from the top-level project root directory:
+
+```shell
+pnpm install
+```
+
+To make sure everything is installed and working properly, we recommend running a build. This command will also build Anvil2 and its dependencies, so it might take a few minutes:
+
+```shell
+pnpm build:common
+```
+
+## Development
+
+To run our Storybook, you can use the following script from the root of the repo:
+
+```shell
+pnpm storybook:common
+```
+
+Our `ext-common` Storybook will be hosted at http://localhost:8008/.
+
+> [!NOTE]
+> For more information about using Storybook, see [their docs](https://storybook.js.org/docs).
+
+## Adding a new component or hook
+
+### Directory structure
+
+```
+- src
+  - components
+    - MyNewComponent
+      - internal
+        - SomeInternalCode.ts
+      - MyNewComponent.tsx
+      - MyNewComponent.stories.tsx
+      - MyNewComponent.test.tsx
+      - index.ts
+    index.ts
+```
+
+To add a new component, you would start by added a new folder in the `src/components` directory for your component. Inside that folder, in addition to the files for your component, you'll want to add an `index.ts` file where you export everything you want to be publicly accessible (component, proptypes, context, etc). Code that is not intended to be public can be organized into an `internal` subdirectory.
+
+Then in the `src/components/index.ts` file, you'll want to add the export for your new component to make sure it gets exported along with all the other components.
+
+```tsx
+export * from "./SomeExistingComponent";
+export * from "./MyNewComponent";
+```
+
+To add new stories to the existing Storybook, you'll need to add a file that ends in `*.stories.tsx` or `*.mdx`.
+
+To add new unit tests to the existing Vitest run, you'll need to add a file that ends in `*.test.tsx` or `test.ts`.
+
+### Adding a new top-level folder in `src`
+
+To add a new top-level folder in the `src` directory works very similarly, just another level higher. You would create a new folder under `src`:
+
+```
+- src
+  - components
+  - hooks
+  - mynewcategory
+  index.ts
+```
+
+...and then add your new folder's exports to the `src/index.ts` file:
+
+```tsx
+export * from "./components";
+export * from "./hooks";
+export * from "./mynewcategory";
+```
+
+## Making a pull request
+
+### Changesets
+
+We use [Changesets](https://github.com/changesets/changesets/blob/main/README.md) to create release notes and manage our release versioning.
+
+When you are ready to create a PR to release a change to this package, run:
+
+```shell
+pnpm changeset
+```
+
+Follow the steps and use appropriate semantic version for your change.
+
+#### Changeset message format
+
+Please format your changelog with name of the relevant components, hooks, or other code in brackets at the start of the changelog, such as:
+
+```md
+---
+"@servicetitan/anvil2": patch
+---
+
+[TextField] Update padding for `TextField` `prefix` and `suffix`
+```
+
+For more details, see our [internal docs on changeset formatting](https://servicetitan.atlassian.net/wiki/spaces/ADS/pages/3426746698/Changesets+Format).
+
+## Other useful scripts
+
+From the root of the monorepo, you can run the following to run scripts specifically for the common library:
+
+```
+pnpm build:common
+pnpm lint:common   # run ESLint
+pnpm test:common   # run Vitest
+pnpm clean         # clear build outputs
+pnpm nuke          # clear build outputs and node_modules
+```

package/dist/ExampleComponent.d.ts

@@ -0,0 +1,6 @@
+export * from './components/ExampleComponent/index'
+export {}
+import _default from './components/ExampleComponent/index'
+export default _default
+export * from './components/ExampleComponent/index'
+export {}

package/dist/ExampleComponent.js

@@ -0,0 +1,4 @@
+const ExampleComponent = {};
+
+export { ExampleComponent, ExampleComponent as default };
+//# sourceMappingURL=ExampleComponent.js.map

package/dist/ExampleComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleComponent.js","sources":["../src/components/ExampleComponent/ExampleComponent.tsx"],"sourcesContent":["export const ExampleComponent = {};\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB;;;;"}

package/dist/ExampleProvider.d.ts

@@ -0,0 +1,6 @@
+export * from './providers/ExampleProvider/index'
+export {}
+import _default from './providers/ExampleProvider/index'
+export default _default
+export * from './providers/ExampleProvider/index'
+export {}

package/dist/ExampleProvider.js

@@ -0,0 +1,4 @@
+const ExampleProvider = {};
+
+export { ExampleProvider, ExampleProvider as default };
+//# sourceMappingURL=ExampleProvider.js.map

package/dist/ExampleProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleProvider.js","sources":["../src/providers/ExampleProvider/ExampleProvider.tsx"],"sourcesContent":["export const ExampleProvider = {};\n"],"names":[],"mappings":"AAAO,MAAM,kBAAkB;;;;"}

package/dist/components/ExampleComponent/ExampleComponent.d.ts

@@ -0,0 +1 @@
+export declare const ExampleComponent: {};

package/dist/components/ExampleComponent/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ExampleComponent';
+export { ExampleComponent as default } from './ExampleComponent';

package/dist/components/index.d.ts

@@ -0,0 +1 @@
+export * from './ExampleComponent';

package/dist/index.d.ts

@@ -1,2 +1,4 @@
+export * from './components';
 export * from './hooks';
+export * from './providers';
 export * from './types';

package/dist/index.js

@@ -1,2 +1,4 @@
+export { default as ExampleComponent } from './ExampleComponent.js';
 export { u as useConfirmDialog } from './useConfirmDialog-DaQ5Golt.js';
+export { default as ExampleProvider } from './ExampleProvider.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/internal/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/providers/ExampleProvider/ExampleProvider.d.ts

@@ -0,0 +1 @@
+export declare const ExampleProvider: {};

package/dist/providers/ExampleProvider/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ExampleProvider';
+export { ExampleProvider as default } from './ExampleProvider';

package/dist/providers/index.d.ts

@@ -0,0 +1 @@
+export * from './ExampleProvider';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@servicetitan/anvil2-ext-common",
-  "version": "0.0.0-rc-1.49.0-20251112153304",
+  "version": "0.0.0-rc-1.49.0-20251114220804",
   "type": "module",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -28,7 +28,7 @@
     "tabbable": "^6.2.0",
     "tinycolor2": "^1.6.0",
     "uuid": "^10.0.0",
-    "@servicetitan/anvil2": "0.0.0-rc-1.49.0-20251112153304"
+    "@servicetitan/anvil2": "0.0.0-rc-1.49.0-20251114220804"
   },
   "peerDependencies": {
     "@types/react": "^18",