Skip to content

chore: fix the install guide and delete unreachable code - #118

Merged
jravani merged 2 commits into
mainfrom
chore/docs-and-dead-code
Sep 30, 2026
Merged

jravani merged 2 commits into
mainfrom
chore/docs-and-dead-code

Conversation

@jravani

@jravani jravani commented Sep 30, 2026

Copy link
Copy Markdown
Member

Brings the install guide in line with v0.6.0 and deletes the files that stopped being reachable when the 3D view replaced the dialog.

What changes

  • docs/installing.md shows Building3DView mounted with the four ConfiguratorServices callbacks, lists its props and each service with its time budget, gives react, react-dom and three as peer dependencies, and corrects the buildBuildingStates signature. It no longer describes BuildingConfiguratorProvider, an HttpClient, the /experimental entry or echarts, none of which exist.
  • Deleted, unreachable by import from src/main.tsx, src/index.ts or any test: GeneralConfig.tsx, RoofConfigurator.tsx, BuildingVisualization.tsx (with its duplicate BuildingElementSource), StepperInput.tsx, scrollUtils.ts, surfaceFactory.ts, testingTasks.ts, and the fixtures demo_config.json, example_buem_response.json, example_building_node.json.
  • Four comments that named the deleted dialog, GeneralConfig or BuildingConfiguratorProvider now name what replaced them.

No behaviour change; no release needed.

Checks

npm test 88/88, npm run typecheck clean, npm run build:lib and vite build succeed.

When the 3D view became the published configurator, the dialog that
mounted these files was deleted, but the files stayed. None is
reachable by import from src/main.tsx, src/index.ts or any test:

- GeneralConfig.tsx, RoofConfigurator.tsx, BuildingVisualization.tsx
  (which also held a second copy of the BuildingElementSource type)
- StepperInput.tsx, scrollUtils.ts, surfaceFactory.ts, testingTasks.ts
- demo_config.json, example_buem_response.json,
  example_building_node.json

Four comments that pointed at the deleted dialog, GeneralConfig or
BuildingConfiguratorProvider now name what replaced them.
docs/installing.md still showed the API before v0.4.0: a
BuildingConfigurator dialog wrapped in BuildingConfiguratorProvider
with a host HttpClient, a separate /experimental entry for the 3D
view, and echarts as a peer dependency. None of those exist.

The page now shows Building3DView mounted with the four
ConfiguratorServices callbacks, lists its props and each service with
its time budget, gives react, react-dom and three as the peer
dependencies, and corrects the buildBuildingStates signature. The
styling, geometry and storing sections are kept as they were.
@jravani
jravani merged commit 83dcc26 into main Sep 30, 2026
3 checks passed
@jravani
jravani deleted the chore/docs-and-dead-code branch September 30, 2026 19:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant